> mcp integration

QuickBooks MCP Server: What It Does & How to Use It with Claude

What the QuickBooks MCP server can do — read invoices, run P&L reports, create transactions — and how to connect it to Claude Cowork, Code, or Desktop.

By Rhode Labs · Updated 2026-06-03

The QuickBooks MCP server lets an AI assistant read and write data in a QuickBooks Online company. It can pull invoices, run a profit-and-loss report, or draft a bill through a standard tool interface. Intuit publishes an official server, so you can wire your books into Claude Cowork, Claude Code, or Claude Desktop without writing custom QBO API code.

What can the QuickBooks MCP server do?

Intuit’s server exposes full CRUD across 29 QuickBooks Online entity types plus 11 financial reports as callable tools.

CapabilityWhat it enables
Read entitiesGet and Search across Customer, Invoice, Bill, Vendor, Item, Account, Payment, and more — “list open invoices for Acme”
Create transactionsCreate Invoice, Estimate, Sales Receipt, Bill, Journal Entry, Purchase Order, and other documents
Update & deleteEdit or void existing records (gated behind separate flags you can disable)
Financial reportsProfit & Loss, Balance Sheet, Cash Flow, Trial Balance, General Ledger, Aged Receivables, and more
Reference dataRead Class, Department, Term, Payment Method, Tax Code/Rate/Agency, and Company Info
Scope controlsSuppress write, update, or delete tool categories via env flags; read tools always remain available

Is the official Intuit server the right one?

  • Official, intuit/quickbooks-online-mcp-server. This is the right default for most teams. It is a local stdio server maintained by Intuit, covering 29 entities and 11 reports with OAuth 2.0, and the QUICKBOOKS_ENVIRONMENT flag lets you point it at a sandbox company for testing or your production QBO company. Start in sandbox to learn the tool surface before touching live books.
  • Community servers. Several alternatives exist. CData ships read-only servers backed by their JDBC drivers, while laf-rge/quickbooks-mcp and nikhilgy/quickbooks-mcp-server are independent implementations that query and edit live QBO data. These vary in scope, maintenance, and trust, so vet them before pointing at real financials.

How do you connect QuickBooks to Claude?

  1. Create a free app on the Intuit Developer Portal and grab your CLIENT_ID and CLIENT_SECRET.
  2. Run the OAuth flow to get a REFRESH_TOKEN and your company’s REALM_ID (the default callback is http://localhost:8000/callback).
  3. Clone and build intuit/quickbooks-online-mcp-server (npm install && npm run build).
  4. Add it to your MCP config. Claude Desktop and Claude Code use the same mcpServers block:
{
  "mcpServers": {
    "quickbooks": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "QUICKBOOKS_CLIENT_ID": "...",
        "QUICKBOOKS_CLIENT_SECRET": "...",
        "QUICKBOOKS_REFRESH_TOKEN": "...",
        "QUICKBOOKS_REALM_ID": "...",
        "QUICKBOOKS_ENVIRONMENT": "sandbox"
      }
    }
  }
}
  1. Start read-only by adding "QUICKBOOKS_DISABLE_WRITE": "true" until you trust the output, then restart the client. Keep QUICKBOOKS_ENVIRONMENT on sandbox while you experiment, and switch to production only once you have reviewed which tools the model can call.

How we use it: It is genuinely good for read-heavy work, like “summarize last quarter’s P&L,” reconciling what an invoice actually says against a spreadsheet, or pulling aged receivables into a draft email. It is bad for blind writes: letting an assistant create journal entries unsupervised in live books is how you get a mess your accountant has to unwind. The realistic gotcha: run it against the sandbox first so the data you query is Intuit’s seeded test company. Don’t switch to production and assume the assistant will write clean entries until you have watched it work.

How do you keep QuickBooks access safe?

Treat accounting access like production credentials. Use OAuth scoped to one company, start with QUICKBOOKS_DISABLE_WRITE (and disable update/delete) so the assistant is read-only first, and keep your client secret and refresh token out of shared configs. Stay in the sandbox until you have reviewed exactly which tools the model can call, then move to production deliberately.

How do you wire QuickBooks into your stack?

The MCP server is the easy part. The value is in the workflow around it: which reports get pulled, what gets drafted vs. auto-posted, and where a human signs off before anything hits the books. If you want help scoping a safe QuickBooks-to-Claude workflow, Book a discovery call.

Sources: official Intuit server · Intuit local MCP early preview · CData community server

Frequently asked questions

Does the QuickBooks MCP server work with Claude?
Yes. Intuit's QuickBooks Online MCP server runs as a local stdio subprocess and works with any MCP client, including Claude Cowork, Claude Code, and Claude Desktop. You add it to the client's MCP config, point it at a QuickBooks Online company via OAuth, and the assistant can call its tools.
Is there an official QuickBooks MCP server?
Yes. Intuit publishes one at github.com/intuit/quickbooks-online-mcp-server. It is a local stdio server covering 29 QuickBooks Online entity types and 11 financial reports. Several community servers (CData, laf-rge, nikhilgy) also exist.
Is the QuickBooks MCP server free?
Intuit's server is open source and free to run. You still need a free Intuit Developer account and an app on the developer portal for OAuth credentials. You can point it at either a sandbox company for testing or your production QuickBooks Online company.
Can the QuickBooks MCP server create invoices and transactions?
Yes. Most of the 29 entities support Create, Get, Update, Delete, and Search. You can disable writes with QUICKBOOKS_DISABLE_WRITE (and separate update/delete) flags so the assistant stays read-only until you trust it.

Start Here

Ready to modernize?

Tell us where your team is stuck. We'll map the path from manual to automated, and show you what's possible in the first two weeks.

Book a Discovery Call