Summary

The connection is yours end to end — your app, your refresh token, no broker in between.

You supply the client ID, secret, refresh token and company ID, and QUICKBOOKS_ENV decides whether you are pointed at sandbox or production, which is worth setting deliberately the first time. Expect the tools to take 10-20 seconds to appear on first launch while it pulls the current QuickBooks API documentation.

What it is

A local-first MCP server for QuickBooks. It authenticates with your own QuickBooks app and answers questions about the company file from inside a chat client.

What you get

Query accounts, bills and customers in natural language
Filter by date — for example bills created after 2024-01-01
Point at sandbox or production with QUICKBOOKS_ENV
Tools rebuilt from the current QuickBooks API documentation at every launch

Requirements

Python 3.10 or higher, uv, and four QuickBooks credentials: QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, QUICKBOOKS_REFRESH_TOKEN and QUICKBOOKS_COMPANY_ID. Your client runs main_quickbooks_mcp.py through uv from the project directory.