How do I install Qbo?

Qbo is a local plugin. Install it using the provided package and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Qbo need?

Qbo requires the following credentials or environment variables: QBO_CLIENT_ID, QBO_CLIENT_SECRET, QBO_REFRESH_TOKEN, QBO_REALM_ID, QBO_ENVIRONMENT, MCP_TRANSPORT, AUTH_MODE, LOG_LEVEL. You can find setup instructions on the server detail page.

What AI apps work with Qbo?

Qbo uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Qbo MCP Server

by Wyre Technology

Developer ToolsUse Caution4.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

MCP server for QuickBooks Online — accounts, customers, invoices, bills, and reports.

About

MCP server for QuickBooks Online — accounts, customers, invoices, bills, and reports.

Security Report

4.2

Use Caution4.2High Risk

This QuickBooks Online MCP server is well-structured with proper authentication mechanisms and reasonable permission scoping for its purpose. However, SQL injection vulnerabilities in query construction and insufficient input validation pose moderate security risks that should be addressed before production use. Supply chain analysis found 3 known vulnerabilities in dependencies (1 critical, 1 high severity).

7 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

QuickBooks Online OAuth2 client ID from the Intuit developer appOptional

Environment variable: QBO_CLIENT_ID

QuickBooks Online OAuth2 client secretRequired

Environment variable: QBO_CLIENT_SECRET

OAuth2 refresh token for the connected QuickBooks companyRequired

Environment variable: QBO_REFRESH_TOKEN

QuickBooks Online company (realm) IDOptional

Environment variable: QBO_REALM_ID

QuickBooks API environment: 'sandbox' or 'production'Optional

Environment variable: QBO_ENVIRONMENT

Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.Optional

Environment variable: MCP_TRANSPORT

Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.Optional

Environment variable: AUTH_MODE

Log verbosity: debug, info, warn, errorOptional

Environment variable: LOG_LEVEL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-wyre-technology-qbo-mcp": {
      "env": {
        "AUTH_MODE": "your-auth-mode-here",
        "LOG_LEVEL": "your-log-level-here",
        "QBO_REALM_ID": "your-qbo-realm-id-here",
        "MCP_TRANSPORT": "your-mcp-transport-here",
        "QBO_CLIENT_ID": "your-qbo-client-id-here",
        "QBO_ENVIRONMENT": "your-qbo-environment-here",
        "QBO_CLIENT_SECRET": "your-qbo-client-secret-here",
        "QBO_REFRESH_TOKEN": "your-qbo-refresh-token-here"
      },
      "args": [
        "-y",
        "@wyre-technology/qbo-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

QuickBooks Online MCP Server

Model Context Protocol (MCP) server for the QuickBooks Online Accounting API. Enables Claude and other MCP-compatible clients to manage QBO customers, invoices, expenses, payments, and reports.

One-Click Deployment

Quick Start

Prerequisites

Node.js >= 20
QuickBooks Online OAuth2 app credentials (requires an Intuit developer account)

Install and Build

npm install
npm run build

Run (stdio mode)

QBO_ACCESS_TOKEN=your-access-token QBO_REALM_ID=your-realm-id npm start

Run (HTTP mode)

MCP_TRANSPORT=http QBO_ACCESS_TOKEN=your-access-token QBO_REALM_ID=your-realm-id npm start

The server listens on http://0.0.0.0:8080/mcp by default.

Docker

docker build -t qbo-mcp .
docker run -p 8080:8080 \
  -e MCP_TRANSPORT=http \
  -e QBO_ACCESS_TOKEN=your-access-token \
  -e QBO_REALM_ID=your-realm-id \
  qbo-mcp

Environment Variables

Variable	Required	Default	Description
`QBO_ACCESS_TOKEN`	Yes (env mode)	—	QuickBooks Online OAuth2 access token
`QBO_REALM_ID`	Yes (env mode)	—	QuickBooks Online company (realm) ID
`MCP_TRANSPORT`	No	`stdio`	Transport type: `stdio` or `http`
`MCP_HTTP_PORT`	No	`8080`	HTTP server port
`MCP_HTTP_HOST`	No	`0.0.0.0`	HTTP server bind address
`AUTH_MODE`	No	`env`	Auth mode: `env` or `gateway`

Gateway Mode

When AUTH_MODE=gateway, credentials are passed per-request via HTTP headers instead of environment variables:

X-Qbo-Access-Token — OAuth2 access token
X-Qbo-Realm-Id — QuickBooks Online company (realm) ID

This allows a gateway/proxy to manage multi-tenant credentials.

Available Tools

Tools are organized into domains. Use qbo_navigate to select a domain, then use the domain-specific tools.

Navigation

qbo_navigate — Select a domain (customers, invoices, expenses, payments, reports)
qbo_back — Return to domain selection

Customers

qbo_customers_list — List customers
qbo_customers_get — Get customer by ID
qbo_customers_create — Create a new customer
qbo_customers_search — Search customers by name or other criteria

Invoices

qbo_invoices_list — List invoices
qbo_invoices_get — Get invoice by ID
qbo_invoices_create — Create a new invoice
qbo_invoices_send — Send an invoice via email

Expenses

qbo_expenses_list_purchases — List purchase transactions
qbo_expenses_list_bills — List bills
qbo_expenses_get_purchase — Get purchase by ID
qbo_expenses_get_bill — Get bill by ID

Payments

qbo_payments_list — List payments
qbo_payments_get — Get payment by ID
qbo_payments_create — Create a new payment

Reports

qbo_reports_profit_and_loss — Generate Profit and Loss report
qbo_reports_balance_sheet — Generate Balance Sheet report
qbo_reports_aged_receivables — Generate Aged Receivables report
qbo_reports_aged_payables — Generate Aged Payables report
qbo_reports_customer_sales — Generate Customer Sales report

License

Apache-2.0

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

mcp-creator-typescript

Free

by mcp-marketplace · Developer Tools

Scaffold, build, and publish TypeScript MCP servers to npm — conversationally

Google Workspace MCP

Free

by Taylorwilsdon · Productivity

Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI

Qbo MCP Server

About

Security Report

Findings (10)Action required

Permissions Required

What You'll Need

How to Install

Documentation

QuickBooks Online MCP Server

One-Click Deployment

Quick Start

Prerequisites

Install and Build

Run (stdio mode)

Run (HTTP mode)

Docker

Environment Variables

Gateway Mode

Available Tools

Navigation

Customers

Invoices

Expenses

Payments

Reports

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

Google Workspace MCP

Qbo MCP Server

About

Security Report

Findings (10)Action required

Permissions Required

What You'll Need

How to Install

Documentation

QuickBooks Online MCP Server

One-Click Deployment

Quick Start

Prerequisites

Install and Build

Run (stdio mode)

Run (HTTP mode)

Docker

Environment Variables

Gateway Mode

Available Tools

Navigation

Customers

Invoices

Expenses

Payments

Reports

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

Google Workspace MCP