quickbooks-mcp
Connects to QuickBooks Desktop (Pro, Premier, Enterprise) through its local SDK, enabling read access to customers, vendors, employees, items, accounts, invoices, bills, payments, inventory, time, custom fields, and standard reports, plus optional create, update, delete, and void operations with previews, confirmation tokens, idempotency keys, and audit logging.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@quickbooks-mcpshow me all unpaid invoices from this quarter"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
quickbooks-mcp
Open-source MCP server that connects QuickBooks Desktop (Pro, Premier, Enterprise) to LLMs and agents.
Status: pre-1.0. Built and tested against recorded responses and the qbXML schema; not yet validated across QuickBooks versions (see COMPATIBILITY.md).
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.
Related MCP server: qbo-mcp
Install
Claude Desktop | open the |
npx |
|
dnx |
|
exe |
|
Then allow access once in QuickBooks (--authorize) and add the server to your AI app. Step by step: docs/GUIDE.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 ( |
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
Roadmap and 1.0 checklist
Legal
Not affiliated with or endorsed by Intuit. See NOTICE.md.
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect QuickBooks Online to AI agents with secure read or write access across multiple companies.
Connect QuickBooks to ChatGPT, Claude & Grok. Record bills, invoices, journal entries. Run reports.
Let AI agents query data and act across all your business apps via MCP.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA secure, local-first MCP server that enables users to query QuickBooks data such as accounts, bills, and customers using natural language within Claude Desktop. It provides a direct interface to the QuickBooks API for streamlined financial data retrieval and management.10-
- AlicenseAqualityDmaintenanceMCP server for QuickBooks Online providing read-only access to customers, vendors, invoices, bills, and chart of accounts. Enables natural language queries to your financial data through Claude or any MCP client.8MIT
- AlicenseNot gradedqualityCmaintenanceA local MCP server that exposes QuickBooks Online data and actions as callable tools for AI assistants, supporting entities like customers, invoices, bills, and financial reports.4MIT
- AlicenseAqualityBmaintenanceThis MCP server enables users to ask natural-language questions about their QuickBooks Online company and receive answers from its live data, with read-only access guaranteed by construction. It runs entirely locally, using tools for receivables, payables, profit/loss, balance sheet, and custom queries.8MIT