QuickBooks Online
CommunityMCP server by wyre-technology · updated · ★ 2
MCP server for QuickBooks Online — accounts, customers, invoices, bills, and reports. QuickBooks Online is a community project by wyre-technology, not verified by a company domain.
Last commit 8 days ago
Apache-2.0: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
QBO_Environment variable | Required | QuickBooks Online OAuth2 client ID from the Intuit developer app |
QBO_Environment variable, secret | Required | QuickBooks Online OAuth2 client secret |
QBO_Environment variable, secret | Required | OAuth2 refresh token for the connected QuickBooks company |
QBO_Environment variable | Required | QuickBooks Online company (realm) ID |
QBO_Environment variable | Optional | QuickBooks API environment: 'sandbox' or 'production' Default: production |
MCP_Environment variable | Optional | Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting. Default: stdio |
AUTH_Environment variable | Optional | Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway. Default: env |
LOG_Environment variable | Optional | Log verbosity: debug, info, warn, error Default: info |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install QuickBooks Online
Built from the published package, never by AIclaude mcp add quickbooks-online -e QBO_CLIENT_ID=YOUR_QBO_CLIENT_ID -e QBO_CLIENT_SECRET=YOUR_QBO_CLIENT_SECRET -e QBO_REFRESH_TOKEN=YOUR_QBO_REFRESH_TOKEN -e QBO_REALM_ID=YOUR_QBO_REALM_ID -- docker run -i --rm -e QBO_CLIENT_ID -e QBO_CLIENT_SECRET -e QBO_REFRESH_TOKEN -e QBO_REALM_ID ghcr.io/wyre-technology/qbo-mcp:v1.6.4Run in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"quickbooks-online": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"QBO_CLIENT_ID",
"-e",
"QBO_CLIENT_SECRET",
"-e",
"QBO_REFRESH_TOKEN",
"-e",
"QBO_REALM_ID",
"ghcr.io/wyre-technology/qbo-mcp:v1.6.4"
],
"env": {
"QBO_CLIENT_ID": "YOUR_QBO_CLIENT_ID",
"QBO_CLIENT_SECRET": "YOUR_QBO_CLIENT_SECRET",
"QBO_REFRESH_TOKEN": "YOUR_QBO_REFRESH_TOKEN",
"QBO_REALM_ID": "YOUR_QBO_REALM_ID"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"quickbooks-online": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"QBO_CLIENT_ID",
"-e",
"QBO_CLIENT_SECRET",
"-e",
"QBO_REFRESH_TOKEN",
"-e",
"QBO_REALM_ID",
"ghcr.io/wyre-technology/qbo-mcp:v1.6.4"
],
"env": {
"QBO_CLIENT_ID": "YOUR_QBO_CLIENT_ID",
"QBO_CLIENT_SECRET": "YOUR_QBO_CLIENT_SECRET",
"QBO_REFRESH_TOKEN": "YOUR_QBO_REFRESH_TOKEN",
"QBO_REALM_ID": "YOUR_QBO_REALM_ID"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"quickbooks-online": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"QBO_CLIENT_ID",
"-e",
"QBO_CLIENT_SECRET",
"-e",
"QBO_REFRESH_TOKEN",
"-e",
"QBO_REALM_ID",
"ghcr.io/wyre-technology/qbo-mcp:v1.6.4"
],
"env": {
"QBO_CLIENT_ID": "YOUR_QBO_CLIENT_ID",
"QBO_CLIENT_SECRET": "YOUR_QBO_CLIENT_SECRET",
"QBO_REFRESH_TOKEN": "YOUR_QBO_REFRESH_TOKEN",
"QBO_REALM_ID": "YOUR_QBO_REALM_ID"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add quickbooks-online --env QBO_CLIENT_ID=YOUR_QBO_CLIENT_ID --env QBO_CLIENT_SECRET=YOUR_QBO_CLIENT_SECRET --env QBO_REFRESH_TOKEN=YOUR_QBO_REFRESH_TOKEN --env QBO_REALM_ID=YOUR_QBO_REALM_ID -- docker run -i --rm -e QBO_CLIENT_ID -e QBO_CLIENT_SECRET -e QBO_REFRESH_TOKEN -e QBO_REALM_ID ghcr.io/wyre-technology/qbo-mcp:v1.6.4{
"mcpServers": {
"quickbooks-online": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"QBO_CLIENT_ID",
"-e",
"QBO_CLIENT_SECRET",
"-e",
"QBO_REFRESH_TOKEN",
"-e",
"QBO_REALM_ID",
"ghcr.io/wyre-technology/qbo-mcp:v1.6.4"
],
"env": {
"QBO_CLIENT_ID": "YOUR_QBO_CLIENT_ID",
"QBO_CLIENT_SECRET": "YOUR_QBO_CLIENT_SECRET",
"QBO_REFRESH_TOKEN": "YOUR_QBO_REFRESH_TOKEN",
"QBO_REALM_ID": "YOUR_QBO_REALM_ID"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add quickbooks-online docker run -i --rm -e QBO_CLIENT_ID -e QBO_CLIENT_SECRET -e QBO_REFRESH_TOKEN -e QBO_REALM_ID ghcr.io/wyre-technology/qbo-mcp:v1.6.4Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the quickbooks-online block.
Weekly newsletter
Like QuickBooks Online? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Alternatives to QuickBooks Online
All alternatives →MCP server integrating with Stripe - tools for customers, products, payments, and more.
Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets
200+ transparent financial metrics calculated from raw statements, not third-party endpoints.
JS API for Yahoo Finance
x402 Payment Protocol
x402 Payment Protocol
QuickBooks Online: common questions
How do I install QuickBooks Online?
In Claude Code run claude mcp add quickbooks-online -e QBO_CLIENT_ID=YOUR_QBO_CLIENT_ID -e QBO_CLIENT_SECRET=YOUR_QBO_CLIENT_SECRET -e QBO_REFRESH_TOKEN=YOUR_QBO_REFRESH_TOKEN -e QBO_REALM_ID=YOUR_QBO_REALM_ID -- docker run -i --rm -e QBO_CLIENT_ID -e QBO_CLIENT_SECRET -e QBO_REFRESH_TOKEN -e QBO_REALM_ID ghcr.io/wyre-technology/qbo-mcp:v1.6.4. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is QuickBooks Online the official server?
QuickBooks Online is a community project by wyre-technology, not verified by a company domain.
Is QuickBooks Online free?
The code is published under the Apache-2.0 licence. The service it connects to may have its own pricing.
Is QuickBooks Online safe to use?
It scores 45 of 100. Grades: maintenance A, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to QuickBooks Online?
Similar MCP servers: mcp, CCXT, Finance Toolkit, Yahoo Finance2.
Does QuickBooks Online work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
