QuickBooks Online MCP Server

Name: QuickBooks Online MCP Server
Author: your-username

your-username

The QuickBooks MCP Server lets AI assistants access QuickBooks data via a standard interface. It uses the Model Context Protocol to expose QBO features as callable tools, enabling developers to build AI apps that fetch real-time QBO data through MCP.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add quickbooks-online --env QUICKBOOKS_CLIENT_ID='<QUICKBOOKS_CLIENT_ID>' --env QUICKBOOKS_CLIENT_SECRET='<QUICKBOOKS_CLIENT_SECRET>' --env QUICKBOOKS_REFRESH_TOKEN='<QUICKBOOKS_REFRESH_TOKEN>' --env QUICKBOOKS_REALM_ID='<QUICKBOOKS_REALM_ID>' --env QUICKBOOKS_ENVIRONMENT='<QUICKBOOKS_ENVIRONMENT>' -- node path/to/mcp-quickbooks-online/dist/index.js

~/.codex/config.toml

[mcp_servers.quickbooks-online]
command = "node"
args = ["path/to/mcp-quickbooks-online/dist/index.js"]
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>", QUICKBOOKS_ENVIRONMENT = "<QUICKBOOKS_ENVIRONMENT>" }

# codex mcp add quickbooks-online --env QUICKBOOKS_CLIENT_ID='<QUICKBOOKS_CLIENT_ID>' --env QUICKBOOKS_CLIENT_SECRET='<QUICKBOOKS_CLIENT_SECRET>' --env QUICKBOOKS_REFRESH_TOKEN='<QUICKBOOKS_REFRESH_TOKEN>' --env QUICKBOOKS_REALM_ID='<QUICKBOOKS_REALM_ID>' --env QUICKBOOKS_ENVIRONMENT='<QUICKBOOKS_ENVIRONMENT>' -- node path/to/mcp-quickbooks-online/dist/index.js

~/.cursor/mcp.json

{
  "mcpServers": {
    "quickbooks-online": {
      "command": "node",
      "args": [
        "path/to/mcp-quickbooks-online/dist/index.js"
      ],
      "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>",
        "QUICKBOOKS_ENVIRONMENT": "<QUICKBOOKS_ENVIRONMENT>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "quickbooks-online": {
      "type": "stdio",
      "command": "node",
      "args": [
        "path/to/mcp-quickbooks-online/dist/index.js"
      ],
      "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>",
        "QUICKBOOKS_ENVIRONMENT": "<QUICKBOOKS_ENVIRONMENT>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "quickbooks-online": {
      "command": "node",
      "args": [
        "path/to/mcp-quickbooks-online/dist/index.js"
      ],
      "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>",
        "QUICKBOOKS_ENVIRONMENT": "<QUICKBOOKS_ENVIRONMENT>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "quickbooks-online": {
      "command": "node",
      "args": [
        "path/to/mcp-quickbooks-online/dist/index.js"
      ],
      "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>",
        "QUICKBOOKS_ENVIRONMENT": "<QUICKBOOKS_ENVIRONMENT>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "quickbooks-online": {
      "command": "node",
      "args": [
        "path/to/mcp-quickbooks-online/dist/index.js"
      ],
      "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>",
        "QUICKBOOKS_ENVIRONMENT": "<QUICKBOOKS_ENVIRONMENT>"
      }
    }
  }
}

Environment variables

QUICKBOOKS_CLIENT_ID
QUICKBOOKS_CLIENT_SECRET
QUICKBOOKS_REFRESH_TOKEN
QUICKBOOKS_REALM_ID
QUICKBOOKS_ENVIRONMENT

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related