QuickBooks Online MCP: Documentation
Updated:
Connection
A local stdio server (git clone + npm install && npm run build, run via node dist/index.js). Env vars: QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, QUICKBOOKS_REFRESH_TOKEN, QUICKBOOKS_REALM_ID, QUICKBOOKS_ENVIRONMENT=sandbox|production. Register your app on the Intuit Developer Portal; sandbox accepts the http://localhost:8000/callback redirect URI (npm run auth runs the OAuth handshake), while production rejects localhost — you'll need a temporary HTTPS tunnel (e.g. ngrok) just for the initial authorization.
Tools
144 tools: CRUD (create_/get_/update_/delete_/search_) across 29 entities — customers, invoices (with get_invoice_pdf), payments, vendor bills and vendors themselves, bill payments, sales receipts, credit and refund notes, deposits, manual journals and more. Plus 11 reports: get_profit_and_loss, get_balance_sheet, get_cash_flow, get_trial_balance, get_general_ledger, get_customer_sales, get_aged_receivables, get_aged_receivables_detail, get_customer_balance, get_aged_payables, get_vendor_expenses.
Agent flow
"Invoice Acme LLC for $1,200", "show me last quarter's P&L", "which vendor bills are overdue?", "create a deposit for today's sales receipts".
Important
The server operates on the company's real accounting records — deletes and edits permanently affect your books. The QUICKBOOKS_DISABLE_WRITE, QUICKBOOKS_DISABLE_UPDATE and QUICKBOOKS_DISABLE_DELETE variables switch off the matching tool categories; start with a sandbox company before connecting production data.
Pricing
The MCP server is free (open source); access to QuickBooks Online itself follows Intuit's plans (a free sandbox company is available for development).