Connects QuickBooks Desktop to LLMs to read financial data and perform safe, authorized changes like creating or updating invoices and customers.
Also known as devwithmj/quickbooks-mcp, quickbooks-mcp, @devwithmj/quickbooks-mcp
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- 1,562
- Latest version
- 0.1.6
- Last commit
- Nov 14, 2026
- License
- MIT
What is QuickBooks Desktop MCP?
QuickBooks Desktop connects QuickBooks Desktop to LLMs to read financial data and perform safe, authorized changes like creating or updating invoices and customers.
Summary generated from the project's README
About QuickBooks Desktop MCP server
Accessing financial records and managing accounting tasks from within an AI client is what this server enables for users of QuickBooks Desktop Pro, Premier, and Enterprise. It runs locally on a Windows PC using the QuickBooks SDK, ensuring data stays on your computer rather than moving through a cloud API. You can connect it to Claude Desktop, Claude Code, or via npx to interact with your company files.
By default, the server operates in a read-only mode to protect your data. It provides access to customers, vendors, employees, invoices, bills, and standard reports like profit and loss or balance sheets. If you choose to enable write permissions using specific flags or environment variables, the server allows for creating, updating, deleting, or voiding records. To maintain security, the system masks bank and card numbers, disables payroll, and requires confirmation tokens or manual approval for destructive actions like voids and deletes.
What you can do with it
- 1Generate financial reportsAsk your AI assistant to pull a profit and loss statement or an aging report from your local QuickBooks file.
- 2Update customer informationInstruct an agent to modify existing customer details or create new customer profiles directly in the desktop software.
- 3Audit financial changesUse the built-in logging to track what modifications the AI has made to your accounting records.
Written from the project's README. Every use case is checked against a quote from it.
How to install QuickBooks Desktop MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall QuickBooks Desktop MCP in Claude Code
$ claude mcp add quickbooks-mcp -- npx -y @devwithmj/quickbooks-mcpInstall QuickBooks Desktop MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"quickbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@devwithmj/quickbooks-mcp"
]
}
}
}Install QuickBooks Desktop MCP in VS Code
.vscode/mcp.json
{
"servers": {
"quickbooks-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@devwithmj/quickbooks-mcp"
]
}
}
}Install QuickBooks Desktop MCP in VS Code CLI
$ code --add-mcp '{"name":"quickbooks-mcp","type":"stdio","command":"npx","args":["-y","@devwithmj/quickbooks-mcp"]}'Install QuickBooks Desktop MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"quickbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@devwithmj/quickbooks-mcp"
]
}
}
}Install QuickBooks Desktop MCP in Codex
$ codex mcp add quickbooks-mcp -- npx -y @devwithmj/quickbooks-mcpInstall QuickBooks Desktop MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.quickbooks-mcp] command = "npx" args = ["-y", "@devwithmj/quickbooks-mcp"]
Install QuickBooks Desktop MCP in Gemini CLI
$ gemini mcp add -s user quickbooks-mcp npx -- -y @devwithmj/quickbooks-mcpInstall QuickBooks Desktop MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"quickbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@devwithmj/quickbooks-mcp"
]
}
}
}Configuration
QB_COMPANY_FILEFull path to the QuickBooks company file (.qbw). Leave empty to use the file open in QuickBooks.
QB_COMPANY_FILEFull path to the QuickBooks company file (.qbw). Leave empty to use the file open in QuickBooks.
| Name | Description | |
|---|---|---|
| QB_COMPANY_FILE | Full path to the QuickBooks company file (.qbw). Leave empty to use the file open in QuickBooks. | |
| QB_COMPANY_FILE | Full path to the QuickBooks company file (.qbw). Leave empty to use the file open in QuickBooks. |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabledevwithmj/quickbooks-mcp is public and reachablegithub.com/devwithmj/quickbooks-mcp ↗Pass
- Package names this repository as its source@devwithmj/quickbooks-mcp names devwithmj/quickbooks-mcp as sourcenpmjs.com/package/@devwithmj/quickbooks-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @devwithmj/quickbooks-mcpnpmjs.com/package/@devwithmj/quickbooks-mcp/v/0.1.6#provenan ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-07github.com/devwithmj/quickbooks-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @devwithmj/quickbooks-mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubquickbooks-mcp
Open-source MCP server that connects QuickBooks Desktop (Pro, Premier, Enterprise) to LLMs and agents.
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
| Claude Desktop | open the .mcpb from the latest release |
| Claude Code | /plugin marketplace add devwithmj/quickbooks-mcp, then /plugin install quickbooks-desktop@quickbooks-mcp |
| npx | npx -y @devwithmj/quickbooks-mcp |
| dnx | dnx DevWithMJ.QuickBooks.Mcp --yes |
| exe | quickbooks-mcp-win-x64.exe (or -win-x86) from the release |
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.
| QuickBooks Online server (Intuit) | This project (Desktop) | |
|---|---|---|
| Targets | QuickBooks Online | QuickBooks Desktop Pro, Premier, Enterprise (Windows) |
| Where it runs | Talks to Intuit's cloud API | On your PC, next to QuickBooks, through its local SDK |
| Setup and sign-in | An Intuit developer app and OAuth | A one-time "allow this app" approval inside QuickBooks (--authorize); no developer account |
| Only on Desktop | Inventory assemblies and sites, price levels, workers comp codes, custom fields via data extensions, opening a record in the QuickBooks window | |
| Only on Online | Attachments, invoice PDFs and other cloud features | |
| Safety default | See that project | Read-only until you enable writes; deletes and voids need your approval; sensitive numbers masked; payroll off; audit log |
| Data path | Through Intuit's cloud | Stays on your computer except what the assistant is shown |
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
QuickBooks Desktop MCP questions
How do I add QuickBooks Desktop MCP to Claude Code?
Run claude mcp add quickbooks-mcp -- npx -y @devwithmj/quickbooks-mcp in your terminal. Add --scope user to make it available in every project.
How do I add QuickBooks Desktop MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Is the server read-only by default?
Yes, the server is read-only unless you explicitly opt in by adding the --allow-writes flag or setting specific environment variables.
How is my data handled?
The server runs locally on your Windows PC and communicates through the QuickBooks SDK without using the cloud or telemetry.