MCP server
Add Mobile Accounting to your AI assistant
Mobile Accounting runs an MCP server, the open standard AI assistants use to work with other apps. Add it to the assistant you already use, sign in once, and ask about your numbers or have it draft expenses, bills, invoices, estimates and journal entries for you to post.
Server address
https://mcp.mobileaccounting.comPaste it where your assistant asks for a remote MCP server or connector URL. There is no API key: you sign in to Mobile Accounting and approve the connection.
What your assistant can do
Fifty-two tools, each working as you, in the sets of books you choose. Your assistant picks the right one from what you ask.
Books and contacts
- list_books
- The sets of books this connection may reach.
- list_categories
- Expense, income and asset categories in a set of books.
- month_end_checklist
- What is still open in a month before you lock it.
- get_card_fee_setting
- Whether a set of books has clients pay the card fee, and the limit where you are.
- missing_receipts
- Bank and card lines with no receipt yet, and the receipts that fit them.
- find_contacts
- Customers and vendors, found by part of the name.
- update_contact
- Correct a customer's or supplier's name, e-mail or postal address.
Invoices, bills and expenses
- find_documents
- Documents by kind, status, contact or date, or only the unpaid ones.
- get_document
- One document: its status, whether it was sent and viewed, paid, due or overdue.
- find_estimates
- Estimates and quotes: sent, accepted, expired, and which became invoices.
- get_installment_plan
- One invoice's or bill's instalment plan: each date, amount, what is paid and how it is collected.
- upcoming_installments
- Instalments due in a date range across every plan, money coming in and going out.
- customer_portal
- Whether the customer portal is on, and when each customer last opened theirs.
Time
- list_time
- The time you tracked in a period, billed or not, with totals.
- unbilled_time
- Billable time not on an invoice yet, by customer (for whoever manages time).
Purchase orders
- find_purchase_orders
- Orders to suppliers by status, or only the ones still open.
- get_purchase_order
- One order: what was received and billed, and whether the bill matches.
- get_on_order
- Stock on hand and on order, item by item, with the next delivery date.
Reports
- profit_and_loss
- Any period, compared with the period or year before, by month or quarter.
- balance_sheet
- What you own and owe on any date.
- cash_flow
- Money in and out over a period.
- cash_forecast
- An estimate of your cash 30, 60 and 90 days out, from what is already in the books.
- insights
- Things in the books worth a look: unusual spending, price increases, likely duplicates, missing receipts, slower payers.
- sales_tax_report
- Tax collected and paid, by tax and jurisdiction.
- tax_set_aside
- Roughly how much to set aside for income tax so far this year, and when the next instalment is due. An estimate, not tax advice.
- sales_tax_returns
- Which sales tax returns are due, and when.
- sales_tax_return_worksheet
- One return laid out by the lines of the form, to check before you file.
- sales_tax_claims
- Refund claims of sales tax and the documents they need.
- unpaid_invoices
- What customers owe you, with ageing.
- unpaid_bills
- What you owe, with ageing.
- spending
- Spending by category or by vendor.
- account_balances
- The balance of every account.
- journal_entries
- Every past entry in a period, with its debit and credit lines.
- general_ledger
- One account’s transactions in a period, with the running balance. Name the account by its code or name.
- sales_by_customer
- Sales per customer over a period, and each one’s share.
- customer_statement
- A customer’s invoices, credits and payments, with the balance due. Nothing is sent to them.
Budgets
- list_budgets
- The budgets of a set of books, by financial year, and which one is active.
- budget_vs_actual
- Budget against actual for any period, by month or quarter, with the difference.
- budget_status
- This month and the year so far against budget, and the categories furthest over.
Sales tax exemptions
- tax_exemption_forms
- The exemption and resale certificates each province and state publishes, with links to the official forms.
- tax_exemption_certificates
- The certificates on file from customers and given to suppliers, and which are about to expire.
- check_tax_exemption
- Whether a sale to a customer or a purchase from a supplier is exempt, and why.
- exempt_sales
- Exempt sales by province or state and reason, for your sales tax return.
Drafts, only if you allow them
- record_expense
- A paid receipt, paid from the bank, a card, cash or the owner.
- record_bill
- A bill to pay later.
- create_invoice
- An invoice for a customer. The assistant never sends it.
- create_estimate
- An estimate or quote for a customer. You send it, and turn it into an invoice.
- log_time
- Hours you worked for a customer, as your own time. Nothing is billed.
- bill_time
- A customer’s unbilled time on a draft invoice. The assistant never sends it.
- draft_purchase_order
- A purchase order to a supplier. The assistant never sends it.
- draft_budget
- A budget for a year, as a version that is never made active. You make it the budget in the app.
- record_journal_entry
- A journal entry: the accounts it debits and credits, balanced. Also to copy or reverse a past entry.
Your assistant writes drafts. You post. It cannot post, send, pay, void or delete anything. Expenses, bills, invoices, estimates, purchase orders and budgets it creates wait in the app as drafts until you check them and post or send them yourself. Time it logs is yours to change or delete, and is billed only on a draft invoice.
How connecting works
- You add the server address to your assistant.
- Your assistant opens Mobile Accounting in your browser, and you sign in there. The assistant never sees your password.
- You tick the sets of books it may reach and whether it may create drafts, then click Allow.
- From then on it works as you, and never beyond what your role on those books allows.
- Disconnect at any time: in the app under Settings, Connected apps, or by removing the connector from your assistant.
Set it up in your assistant
Pick your assistant. Where it can install from a link, one click does it. Everywhere else it takes a minute of copy and paste.
Claude
Claude on the web, the desktop app and the mobile apps
- In Claude, open Customize, then Connectors.
- Select Add, then Add custom connector.
- Name it Mobile Accounting, paste the server address and click Continue.
- Keep the sign-in settings Claude marks Detected, then click Add.
- Click Connect, sign in to Mobile Accounting, choose your books and click Allow.
On Team and Enterprise plans an Owner adds the connector under Organization settings, Connectors, and each member then clicks Connect. The Free plan allows one custom connector.
https://mcp.mobileaccounting.comClaude Code
Claude in your terminal or editor
- Run the command below in a terminal.
- In Claude Code, type /mcp, choose mobile-accounting and select Authenticate.
- Sign in to Mobile Accounting in the browser that opens, choose your books and click Allow.
Add --scope user to the command to use it in every project, not only the current one.
claude mcp add --transport http mobile-accounting https://mcp.mobileaccounting.comChatGPT
ChatGPT on the web, with developer mode
- In ChatGPT on the web, open Settings, then Apps (Apps & Connectors on some plans).
- Under Advanced settings, turn on Developer mode.
- Select Create, name it Mobile Accounting and paste the server address.
- Set Authentication to OAuth, confirm that you trust the app, and select Create.
- Sign in to Mobile Accounting, choose your books and click Allow.
- In a new chat, turn Mobile Accounting on from the + menu, then ask.
Developer mode is offered on paid ChatGPT plans, and on Business, Enterprise and Edu an admin may need to allow it first. OpenAI renames these menus from time to time; its help centre has the current names.
https://mcp.mobileaccounting.comCursor
The Cursor editor
One click
- Click Add to Cursor. Cursor opens and shows the server.
- Select Install.
- When Cursor shows that mobile-accounting needs a sign-in, select it, sign in to Mobile Accounting, choose your books and click Allow.
Or by hand: Add the block below to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json for one project.
{
"mcpServers": {
"mobile-accounting": {
"url": "https://mcp.mobileaccounting.com"
}
}
}VS Code and GitHub Copilot
Copilot Chat in Visual Studio Code
- Click Install in VS Code (or VS Code Insiders). The page opens VS Code, which shows the server.
- Select Install, then start the server when VS Code asks.
- Sign in to Mobile Accounting in the browser that opens, choose your books and click Allow.
- In Copilot Chat, use Agent mode. The Mobile Accounting tools are in the tools list.
Or by hand: Run MCP: Add Server from the Command Palette, choose HTTP, paste the server address and name it mobile-accounting. Or use the file or the terminal command below.
{
"servers": {
"mobile-accounting": {
"type": "http",
"url": "https://mcp.mobileaccounting.com"
}
}
}code --add-mcp '{"name":"mobile-accounting","type":"http","url":"https://mcp.mobileaccounting.com"}'Windsurf
Windsurf and Devin Desktop
- Open the MCP settings: in Windsurf, the MCP servers panel in Cascade; in Devin Desktop, Customize, then MCPs.
- Open the raw configuration, mcp_config.json, and add the block below.
- Save, refresh the server list, and sign in to Mobile Accounting when asked.
Windsurf is now called Devin Desktop. It still reads ~/.codeium/windsurf/mcp_config.json.
{
"mcpServers": {
"mobile-accounting": {
"serverUrl": "https://mcp.mobileaccounting.com"
}
}
}Any other MCP client
Gemini, Grok, Copilot Studio and any assistant or tool that supports MCP
- Find where your client adds a remote MCP server. It may be called a connector, an integration or a tool.
- Paste the server address. If asked for a transport, choose Streamable HTTP. Leave any API key empty.
- Sign in to Mobile Accounting when asked, choose your books and click Allow.
A client that reads a JSON file takes the first block. A client that only runs local servers can reach us through the mcp-remote bridge in the second block, which needs Node.js.
{
"mcpServers": {
"mobile-accounting": {
"type": "http",
"url": "https://mcp.mobileaccounting.com"
}
}
}{
"mcpServers": {
"mobile-accounting": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.mobileaccounting.com"
]
}
}
}For developers and AI clients
The server speaks MCP over Streamable HTTP and signs people in with OAuth 2.1: authorization code with PKCE and dynamic client registration, no API keys. Tools are listed at run time with tools/list. These documents describe it:
- Server cardhttps://mcp.mobileaccounting.com/server-card
- AI catalogue for this sitehttps://mobileaccounting.com/.well-known/ai-catalog.json
- llms.txthttps://mobileaccounting.com/llms.txt
- OAuth protected resource metadatahttps://mcp.mobileaccounting.com/.well-known/oauth-protected-resource
- MCP Registry name
com.mobileaccounting/mcp
Questions
- Which assistants work with Mobile Accounting?
- Any assistant or editor that can add a remote MCP server: Claude, ChatGPT, Cursor, VS Code with GitHub Copilot, Windsurf and many more. Whether yours can add one depends on its plan.
- Do I need an API key?
- No. You sign in to Mobile Accounting in your browser and approve the connection. Your assistant never sees your password.
- Can my assistant change my books?
- Only by creating draft expenses, bills, invoices, estimates and journal entries, and only if you allowed drafts when you connected. It cannot post, send, pay, void or delete anything. You check each draft and post it in the app.
- Which books can it see?
- Only the sets of books you tick when you connect, and only while you are an Owner, Admin, Accountant or Bookkeeper on them.
- Can it read a photo of a receipt?
- Yes. Your assistant reads the photo with its own model and sends the figures as a draft. When it can open the file itself, it attaches the photo to the draft too; otherwise attach it in the app when you post.
- Who sees what I type to my assistant?
- Your assistant’s provider, under its own terms. Mobile Accounting receives only the requests your assistant makes for figures and drafts.
- How do I disconnect an assistant?
- In the app, open Settings, then Connected apps, and disconnect it. Removing the connector from your assistant ends the connection too.
Your assistant needs your books first
Create a Mobile Accounting account and set up your books, then connect the assistant you already use.