QuickBooks Online MCP Server

by mindstoneio.github.mindstone/mcp-server-quickbooksv0.4.2

QuickBooks Online MCP server: invoices, bills, customers, vendors, employees, and accounts

12Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install QuickBooks Online MCP server

claude mcp add quickbooks-mindstone -e QUICKBOOKS_CLIENT_ID='<quickbooks-client-id>' -e QUICKBOOKS_CLIENT_SECRET='<quickbooks-client-secret>' -e QUICKBOOKS_REFRESH_TOKEN='<quickbooks-refresh-token>' -e QUICKBOOKS_REALM_ID='<quickbooks-realm-id>' -- npx -y @mindstone/mcp-server-quickbooks

{
  "mcpServers": {
    "quickbooks-mindstone": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-quickbooks"
      ],
      "env": {
        "QUICKBOOKS_CLIENT_ID": "<quickbooks-client-id>",
        "QUICKBOOKS_CLIENT_SECRET": "<quickbooks-client-secret>",
        "QUICKBOOKS_REFRESH_TOKEN": "<quickbooks-refresh-token>",
        "QUICKBOOKS_REALM_ID": "<quickbooks-realm-id>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "quickbooks-mindstone": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-quickbooks"
      ],
      "env": {
        "QUICKBOOKS_CLIENT_ID": "<quickbooks-client-id>",
        "QUICKBOOKS_CLIENT_SECRET": "<quickbooks-client-secret>",
        "QUICKBOOKS_REFRESH_TOKEN": "<quickbooks-refresh-token>",
        "QUICKBOOKS_REALM_ID": "<quickbooks-realm-id>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "quickbooks-mindstone": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-quickbooks"
      ],
      "env": {
        "QUICKBOOKS_CLIENT_ID": "<quickbooks-client-id>",
        "QUICKBOOKS_CLIENT_SECRET": "<quickbooks-client-secret>",
        "QUICKBOOKS_REFRESH_TOKEN": "<quickbooks-refresh-token>",
        "QUICKBOOKS_REALM_ID": "<quickbooks-realm-id>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "quickbooks-mindstone": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-quickbooks"
      ],
      "env": {
        "QUICKBOOKS_CLIENT_ID": "<quickbooks-client-id>",
        "QUICKBOOKS_CLIENT_SECRET": "<quickbooks-client-secret>",
        "QUICKBOOKS_REFRESH_TOKEN": "<quickbooks-refresh-token>",
        "QUICKBOOKS_REALM_ID": "<quickbooks-realm-id>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
QUICKBOOKS_CLIENT_ID	yes	—	Intuit Developer app client ID
QUICKBOOKS_CLIENT_SECRET	yes	yes	Intuit Developer app client secret
QUICKBOOKS_REFRESH_TOKEN	yes	yes	OAuth 2.0 refresh token
QUICKBOOKS_REALM_ID	yes	—	QuickBooks company (realm) ID
QUICKBOOKS_ENVIRONMENT	—	—	sandbox or production
MCP_HOST_BRIDGE_STATE	—	—	Optional path to a host bridge state file used for credential management
MINDSTONE_REBEL_BRIDGE_STATE	—	—	Backwards-compatible alias for MCP_HOST_BRIDGE_STATE

Freshness

Active — last maintenance signal 10d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-29 · 10d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-10 · 2mo ago · official registry · v0.4.2

FAQ

›How do I install the QuickBooks Online MCP server in Claude Code?

Run: claude mcp add quickbooks-mindstone -e QUICKBOOKS_CLIENT_ID='<quickbooks-client-id>' -e QUICKBOOKS_CLIENT_SECRET='<quickbooks-client-secret>' -e QUICKBOOKS_REFRESH_TOKEN='<quickbooks-refresh-token>' -e QUICKBOOKS_REALM_ID='<quickbooks-realm-id>' -- npx -y @mindstone/mcp-server-quickbooks. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does QuickBooks Online require an API key?

Yes. It expects QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, QUICKBOOKS_REFRESH_TOKEN, QUICKBOOKS_REALM_ID, of which 2 are secrets.

›Can I use QuickBooks Online as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is QuickBooks Online in the official MCP registry?

Yes, as io.github.mindstone/mcp-server-quickbooks.