Accounting & Reporting 8 min read Updated September 2026

QuickBooks MCP for Claude — Setup and Options

How to connect QuickBooks Online to Claude with an MCP server — the community server options, Intuit OAuth 2.0 setup, the tools for invoices, bills and financial reports, and the accounting-computation layer that sits on top.

A QuickBooks MCP pulls the ledger; the accounting computation sits on top. Our Accounting MCP adds 20 tools for lease/revenue schedules, VAT and variance commentary — free key.
Get a free key →

Educational content, not professional advice — AI output and figures here can be wrong. Verify before you rely on it. Full disclaimer →

A QuickBooks MCP server connects Claude to your QuickBooks Online company file through the Intuit Accounting API — invoices, bills, customers, vendors, accounts, bank transactions and the financial reports — without CSV exports. Intuit has not shipped a first-party MCP server; the working routes are a community server or a thin server you build on the Intuit API. This guide covers both, the setup, and what the connector does not do.

QuickBooks MCP options

  • Community MCP servers — several open-source QuickBooks Online MCP servers exist (Node and Python), wrapping the Intuit Accounting API and exposing read tools, and in some cases write tools, for the main entities. They vary in coverage and maintenance; check the entity list and the last commit date before adopting one.
  • Hosted connectors — no-code integration platforms offer hosted QuickBooks MCP endpoints with OAuth handled for you. Fastest to stand up; you are trusting a third party with the token.
  • Build your own — the Intuit Accounting API is well-documented and stable. A minimal server that wraps query (which accepts a SQL-like syntax over QuickBooks entities) plus the Reports endpoints covers most analytical use in a few hundred lines.

Setting up the Intuit OAuth 2.0 connection

  1. Create an app in the Intuit Developer portal. You get a client ID and client secret and set a redirect URI. Choose the com.intuit.quickbooks.accounting scope for the Accounting API.
  2. Run the OAuth 2.0 authorization-code flow once to get an access token and a refresh token, plus the realmId (the QuickBooks company ID). Access tokens last ~1 hour; the server refreshes them with the refresh token.
  3. Point at the right base URLsandbox-quickbooks.api.intuit.com for testing, quickbooks.api.intuit.com for production.
  4. Add the server to claude_desktop_config.json under "mcpServers", passing the client ID, client secret, refresh token and realmId as environment variables. Restart Claude Desktop and confirm by asking Claude to pull a report.

What you can do once connected

  • "Pull the profit and loss from QuickBooks for the last three months and tell me which expense accounts grew fastest, in dollars and percent."
  • "List every open bill in QuickBooks due in the next 14 days, grouped by vendor, with the total."
  • "Get the A/R aging report. Draft a payment-reminder email for each invoice over 45 days past due, referencing the invoice number and amount."
  • "Compare this quarter's balance sheet to the same quarter last year and write a short movement commentary."
  • "Find possible duplicate bills in QuickBooks — same vendor, same amount, within 14 days — and list them for review before the payment run."

Where the MCP connector stops

The QuickBooks MCP returns what QuickBooks holds and, in write mode, creates records in it. It does not run the accounting computations that live outside the ledger:

  • ASC 842 / IFRS 16 lease right-of-use asset and liability schedules
  • ASC 606 / IFRS 15 revenue recognition allocation across periods
  • Multi-state sales tax nexus, or multi-jurisdiction VAT/GST reconciliation
  • Depreciation schedules (straight-line, declining balance, MACRS)
  • Three-statement forecasts, working-capital analysis, R&D tax credit calculations

That is the layer ClaudeFinanceLab's Accounting MCP adds — run it alongside the QuickBooks server: QuickBooks supplies the numbers, the Accounting MCP does the standards-based computation and drafts the commentary. A free API key (100 calls/day, no card) covers a real month-end test.

ClaudeFinanceLab's QuickBooks connector

ClaudeFinanceLab maintains an open, read-only reference QuickBooks Online MCP server (quickbooks_mcp). It manages the Intuit OAuth 2.0 refresh lifecycle, exposes a query tool over the QuickBooks query language plus wrappers for P&L, balance sheet, A/R aging, invoices, bills and customers, and flattens the report payloads to plain tables. Install it with pip install claudefinancelab-mcp (console script quickbooks-mcp) and run it self-hosted with your own Intuit app credentials, refresh token and realmId in the environment. It is built to pair with the Accounting MCP for the computation layer.

QuickBooks MCP vs. a full integration

An MCP gives one analyst direct conversational access to one company file in a Claude session, with nothing new to administer. A platform integration (a post-accounting or reporting product) gives standardised working papers, review workflows and multi-client dashboards. Firms serving many clients usually run both — the accounting-firm MCP comparison covers the trade-offs.

Related guides

Frequently Asked Questions

Is there an official QuickBooks MCP server?

Not from Intuit as of 2026. The working options are community open-source QuickBooks Online MCP servers, hosted connectors from integration platforms, or a thin server you build on the Intuit Accounting API (which is stable and well-documented). Check any community server's entity coverage and maintenance status before adopting it.

What authentication does a QuickBooks MCP use?

Intuit OAuth 2.0. You create an app in the Intuit Developer portal for a client ID and secret, run the authorization-code flow once to get an access token, a refresh token and the realmId (company ID), and the server refreshes the ~1-hour access token automatically. Use the com.intuit.quickbooks.accounting scope.

Can a QuickBooks MCP write to QuickBooks?

Depending on the server, yes — create invoices, bills, customers, journal entries. Prefer read-only scopes and enable write access only for the specific workflows that need it, with the same review discipline you would apply to a junior bookkeeper.

What can't the QuickBooks MCP do?

It is a ledger-access layer, not an accounting engine. It will not build ASC 842 lease schedules, run ASC 606 revenue allocation, handle multi-state sales tax nexus, compute depreciation schedules, or produce three-statement forecasts. Those computations sit on top of the ledger data — which is what ClaudeFinanceLab's Accounting MCP adds alongside the QuickBooks server.

Using Claude at your firm?

Connect Claude to live financial data via MCP — EDGAR, FDIC, BIS, CME and 18 more.

New guides & tools — free

Get notified when we add new MCP servers, finance AI guides, and eval results.

Try These Skills

Browse all Accounting tools →
FEEDBACK