QuickBooks Desktop

quickbooks-mcp

Open-source MCP server that connects QuickBooks Desktop (Pro, Premier, Enterprise) to LLMs and agents.

[npm] [NuGet] [Release] [License: MIT]

Status: pre-1.0. Run so far against QuickBooks Desktop Enterprise Accountant 24.0 with Intuit's sample company file; other editions and years are not yet tested (see COMPATIBILITY.md, and the tester guide if you can help).

What you get

• Read: customers, vendors, employees, items, accounts, invoices, bills, payments, inventory, time, custom fields, and every standard report (aging, P&L, balance sheet, ...), as compact tables.
• Change, only if you allow it: create, update, delete and void, with previews, confirmation tokens, idempotency keys, batches and an audit log.
• Safe by default: read-only, tax IDs and bank and card numbers masked, payroll off, card data never accepted.
• Local: runs on your Windows PC next to QuickBooks and talks to it through its SDK. No cloud, no telemetry.

Install

Then allow access once in QuickBooks (--authorize) and add the server to your AI app. Step by step: docs/GUIDE.md.

Packages and listings: npm, NuGet, GitHub releases, the official MCP Registry (io.github.devwithmj/quickbooks-mcp) and Glama.

Turn on changes

Everything is read-only until you opt in. Add the flag to the arguments your MCP client starts the server with:

"args": ["-y", "@devwithmj/quickbooks-mcp", "--allow-writes"]

or set an environment variable: QB_ALLOW_WRITES=true for everything, or QB_ENABLE_WRITE, QB_ENABLE_UPDATE and QB_ENABLE_DELETE for one kind each (QB_WRITE_ALLOW=Invoice,Customer limits which record types can change). Deletes and voids always need a confirmation step. Details: docs/WRITES.md.

Use it over HTTP (advanced)

Most clients start the server themselves. For a client that cannot, quickbooks-mcp --http serves MCP over HTTP on 127.0.0.1:8765 only, and every request needs an access key (printed at start, or set QB_HTTP_KEY). Changes stay off unless you also pass --http-allow-writes. To reach it from another device, put your own tunnel in front of it: docs/REMOTE-ACCESS.md.

QuickBooks Online or Desktop?

This project is for QuickBooks Desktop. If you use QuickBooks Online, use Intuit's own server: intuit/quickbooks-online-mcp-server (Apache-2.0). We read its design for ideas and wrote our own code; no code was copied.

The two do not share a company file or an account: a business on Online should not use this project, and a Desktop business cannot use Intuit's.

Requirements

• Windows with QuickBooks Desktop installed and licensed.
• Admin access to the company file for the one-time authorization.

Not for QuickBooks Online (Intuit has its own MCP server), QuickBooks for Mac (no SDK), card processing, or running as a Windows service. See docs/SCOPE.md.

Documentation

• User guide: install, authorize, connect clients, troubleshoot, FAQ
• Tools: every tool, parameter and example
• Prompt cookbook, Writes and Reports
• Scope and non-goals and security model
• Roadmap and 1.0 checklist
• Support, upgrades and uninstall, Compatibility, Performance
• Building from source, Releasing, Testing, Contributing

Legal

Not affiliated with or endorsed by Intuit. See NOTICE.md.

License

MIT