MCP Server 🐳 Docker

QuickBooks Online MCP

MCP server for QuickBooks Online. Manage customers, invoices, expenses, payments, and run financial reports.

Installation

Run the MCP server with npx:

npx @wyre-technology/qbo-mcp

Or install the package:

npm install @wyre-technology/qbo-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "qbo": {
      "command": "npx",
      "args": [
        "@wyre-technology/qbo-mcp"
      ],
      "env": {
        "QBO_ACCESS_TOKEN": "your-qbo-access-token",
        "QBO_REALM_ID": "your-qbo-realm-id"
      }
    }
  }
}

Authentication

Variable	Required	Description
`QBO_ACCESS_TOKEN`	Yes	OAuth 2.0 access token for QuickBooks Online
`QBO_REALM_ID`	Yes	Your QuickBooks Online company ID (realm ID)

Architecture

Single TypeScript MCP server supporting both stdio and Streamable HTTP transports.

Available Tools (20)

Tools are organized into 5 domains:

Customers

Manage customer records.

Tool	Description
`List customers`	List customers with filtering
`Get customer`	Get customer details
`Create customer`	Create a new customer
`Search customers`	Search customers by name or email

Invoices

Create and manage invoices.

Tool	Description
`List invoices`	List invoices with filtering
`Get invoice`	Get invoice details
`Create invoice`	Create a new invoice
`Send invoice`	Email an invoice to a customer

Expenses

View purchases and bills.

Tool	Description
`List purchases`	List expense purchases
`List bills`	List vendor bills
`Get purchase`	Get purchase details
`Get bill`	Get bill details

Payments

Record and view customer payments.

Tool	Description
`List payments`	List payments received
`Get payment`	Get payment details
`Create payment`	Record a customer payment

Reports

Generate financial reports.

Tool	Description
`Profit & Loss`	Generate a P&L report
`Balance Sheet`	Generate a balance sheet report
`Aged Receivables`	Generate aged receivables report
`Aged Payables`	Generate aged payables report
`Customer Sales`	Generate customer sales report