QuickBooks Online MCP Server

Add to your client

Copy the config for your MCP client and paste it into its config file.

{
  "mcpServers": {
    "quickbooks-online-mcp-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/quickbooks-online-mcp-server/dist/index.js"
      ],
      "env": {
        "QUICKBOOKS_REALM_ID": "<your-qbo-realm-id>",
        "QUICKBOOKS_CLIENT_ID": "<your-qbo-client-id>",
        "QUICKBOOKS_ENVIRONMENT": "sandbox",
        "QUICKBOOKS_CLIENT_SECRET": "<your-qbo-client-secret>",
        "QUICKBOOKS_REFRESH_TOKEN": "<your-qbo-refresh-token>"
      }
    }
  }
}

Before you start

• Node.js 18 or higher
• A QuickBooks (Intuit) Developer account and an app created in the Intuit Developer Portal
• OAuth 2.0 credentials from the app's Keys & Credentials page: Client ID and Client Secret
• A Realm ID (QuickBooks company ID) and a refresh token obtained via the included OAuth handshake
• An MCP-compatible client such as Claude Desktop

About QuickBooks Online MCP Server

Tools & capabilities (11)

When to use it

• You want an AI assistant to pull live QuickBooks data — invoices, bills, customers, accounts — into a conversation
• You need to generate financial reports like P&L, Balance Sheet, or Cash Flow on demand
• You are building an AI accounting workflow and want to create or update invoices, bills, and payments programmatically
• You want a read-only QBO connection for safe analysis by disabling write/update/delete tools
• You are prototyping against the QuickBooks Sandbox before integrating QBO into a production app

Quick setup

1. 1Create an app in the Intuit Developer Portal and copy the Client ID and Client Secret from Keys & Credentials
2. 2Clone the repo, then run `npm install` and `npm run build`
3. 3Copy `.env.example` to `.env` and fill in your credentials, Realm ID, and environment (sandbox)
4. 4Run `npm run auth` to complete the browser-based OAuth handshake and obtain a refresh token
5. 5Configure your MCP client (e.g. Claude Desktop) with the built server path and environment variables, then restart it
6. 6Optionally set QUICKBOOKS_DISABLE_WRITE/UPDATE/DELETE to lock the server to read-only

QuickBooks Online MCP Server FAQ