QuickBooks MCP
MCP server giving Claude (or any MCP-compatible client) safe, structured access to QuickBooks Online -- invoices, expenses, customers, vendors, reports, and the full chart of accounts. 18 tools across 6 surfaces. OAuth 2.0 setup is one command. Token refresh is automatic. Install in 5 minutes; wire into Claude Desktop / Claude Code / Cursor. WHAT'S INSIDE 18 tools: * Invoices: invoices_list, invoices_get, invoices_create, invoices_send, invoices_mark_paid, invoices_void * Expenses: expenses_list, expenses_create * Customers: customers_list, customers_get, customers_create * Vendors: vendors_list, vendors_create * Reports: reports_profit_and_loss, reports_balance_sheet, reports_cash_flow * Chart of accounts: accounts_list, accounts_lookup_by_name TOOL DESIGN PRINCIPLES * Explicit JSON Schema on every input. No positional args, no untyped strings. * Stable response shapes -- tool outputs are shaped by Brae, not raw QBO passthrough. * Typed errors. Every QBO failure becomes {code, message, status, details}. Stable codes Claude can switch on (qbo_not_found, qbo_validation_failed, qbo_rate_limited, oauth_error). * No silent writes. Every write is acknowledged; every failure is structured. * Tiny dependency surface: mcp + httpx. No heavyweight Intuit SDK. OAUTH HANDLED FOR YOU The QBO access token expires every hour. The refresh token lasts 100 days and rotates on each use. Both are persisted to your config automatically -- you should never have to think about it. First-time setup is one command: `brae-quickbooks-mcp --setup` opens your browser, captures the OAuth callback at localhost:8765, and writes the tokens. INSTALL IN 5 MINUTES pip install brae-quickbooks-mcp brae-quickbooks-mcp --print-config-template > ~/.config/brae/quickbooks/config.toml $EDITOR ~/.config/brae/quickbooks/config.toml # paste client_id + client_secret brae-quickbooks-mcp --setup # one-time OAuth dance Then point Claude Desktop / Claude Code / Cursor at the brae-quickbooks-mcp command. WHAT YOU CAN ASK CLAUDE * Pull our P&L for May. * Create an invoice to Acme Ltd for 5 hours of consulting at $150/hr, due in 14 days. * Record an ACH payment of $1,250 against invoice 1042 and send a thank-you. * Create an expense for AWS -- $89.12 charged to the Brae corporate Visa. * Who's our largest outstanding A/R? * What was our cash balance as of yesterday? INCLUDED * Python package (pip-installable, pyproject.toml ready) + Gumroad zip download * 38 mocked-API tests (pytest + respx). No live API or sandbox calls in CI. * README, EXAMPLES.md (8 worked prompts), CHANGELOG, LICENSE * Single-developer license: unlimited company files you operate, plus client work PAIRS WELL WITH * Shopify Ops MCP ($49): pair with QBO for end-to-end commerce + bookkeeping * Cursor Rules - Rails 8 ($9) / Next.js 15 ($9): for the app layer above Updates free for life via your Gumroad library. Built by Brae, a studio for the people who build things.
Get it → wattn.gumroad.com