Skip to content
Mobile Accounting

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.com

Paste 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 vendor'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 installment plan: each date, amount, what is paid and how it is collected.
upcoming_installments
Installments 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 aging.
unpaid_bills
What you owe, with aging.
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 fiscal 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

  1. You add the server address to your assistant.
  2. Your assistant opens Mobile Accounting in your browser, and you sign in there. The assistant never sees your password.
  3. You tick the sets of books it may reach and whether it may create drafts, then click Allow.
  4. From then on it works as you, and never beyond what your role on those books allows.
  5. 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

  1. In Claude, open Customize, then Connectors.
  2. Select Add, then Add custom connector.
  3. Name it Mobile Accounting, paste the server address and click Continue.
  4. Keep the sign-in settings Claude marks Detected, then click Add.
  5. 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.

Server address
https://mcp.mobileaccounting.com

Claude Code

Claude in your terminal or editor

  1. Run the command below in a terminal.
  2. In Claude Code, type /mcp, choose mobile-accounting and select Authenticate.
  3. 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.

Terminal
claude mcp add --transport http mobile-accounting https://mcp.mobileaccounting.com

ChatGPT

ChatGPT on the web, with developer mode

  1. In ChatGPT on the web, open Settings, then Apps (Apps & Connectors on some plans).
  2. Under Advanced settings, turn on Developer mode.
  3. Select Create, name it Mobile Accounting and paste the server address.
  4. Set Authentication to OAuth, confirm that you trust the app, and select Create.
  5. Sign in to Mobile Accounting, choose your books and click Allow.
  6. 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 center has the current names.

Server address
https://mcp.mobileaccounting.com

Cursor

The Cursor editor

One click

  1. Click Add to Cursor. Cursor opens and shows the server.
  2. Select Install.
  3. 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.

~/.cursor/mcp.json
{
  "mcpServers": {
    "mobile-accounting": {
      "url": "https://mcp.mobileaccounting.com"
    }
  }
}

VS Code and GitHub Copilot

Copilot Chat in Visual Studio Code

  1. Click Install in VS Code (or VS Code Insiders). The page opens VS Code, which shows the server.
  2. Select Install, then start the server when VS Code asks.
  3. Sign in to Mobile Accounting in the browser that opens, choose your books and click Allow.
  4. 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.

.vscode/mcp.json
{
  "servers": {
    "mobile-accounting": {
      "type": "http",
      "url": "https://mcp.mobileaccounting.com"
    }
  }
}
Or from a terminal
code --add-mcp '{"name":"mobile-accounting","type":"http","url":"https://mcp.mobileaccounting.com"}'

Windsurf

Windsurf and Devin Desktop

  1. Open the MCP settings: in Windsurf, the MCP servers panel in Cascade; in Devin Desktop, Customize, then MCPs.
  2. Open the raw configuration, mcp_config.json, and add the block below.
  3. 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.

~/.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

  1. Find where your client adds a remote MCP server. It may be called a connector, an integration or a tool.
  2. Paste the server address. If asked for a transport, choose Streamable HTTP. Leave any API key empty.
  3. 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.

MCP client configuration (JSON)
{
  "mcpServers": {
    "mobile-accounting": {
      "type": "http",
      "url": "https://mcp.mobileaccounting.com"
    }
  }
}
A client that only runs local servers, through mcp-remote
{
  "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:

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.