QuickBooks Online MCP Server

---

Overview

This MCP server provides complete QuickBooks Online API integration for Claude Code and other MCP-compatible clients. It includes full CRUD operations for 29 entity types and 11 financial reports, giving you comprehensive access to QuickBooks Online functionality.

Key Features

• 144 Total Tools - Complete coverage of QuickBooks Online API
• 29 Entity Types - Full CRUD operations (Create, Read, Update, Delete, Search)
• 11 Financial Reports - Balance Sheet, P&L, Cash Flow, and more
• OAuth 2.0 Authentication - Secure token-based authentication
• TypeScript - Full type safety with Zod validation
• Tested - Jest test suite with ESM support

Note: this is a local MCP server. It runs as a stdio subprocess on the developer's or partner's machine and authenticates to a QuickBooks Online company.

---

Quick Start

Installation

# Clone the repository
git clone https://github.com/your-username/mcp-quickbooks-online.git
cd mcp-quickbooks-online

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Copy the template .env.example to .env in the root directory and fill in your values:

cp .env.example .env

QUICKBOOKS_CLIENT_ID=your_client_id
QUICKBOOKS_CLIENT_SECRET=your_client_secret
QUICKBOOKS_ENVIRONMENT=sandbox
QUICKBOOKS_REFRESH_TOKEN=your_refresh_token
QUICKBOOKS_REALM_ID=your_realm_id

.env is gitignored so your real credentials stay local.

Claude Code Integration

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "quickbooks": {
      "command": "node",
      "args": ["path/to/mcp-quickbooks-online/dist/index.js"],
      "env": {
        "QUICKBOOKS_CLIENT_ID": "your_client_id",
        "QUICKBOOKS_CLIENT_SECRET": "your_client_secret",
        "QUICKBOOKS_REFRESH_TOKEN": "your_refresh_token",
        "QUICKBOOKS_REALM_ID": "your_realm_id",
        "QUICKBOOKS_ENVIRONMENT": "sandbox"
      }
    }
  }
}

---

Available Tools

Entities

Complete CRUD operations are available for all entity types:

Entity	Create	Get	Update	Delete	Search
Customer	✅	✅	✅	✅	✅
Invoice	✅	✅	✅	✅	✅
Estimate	✅	✅	✅	✅	✅
Bill	✅	✅	✅	✅	✅
Vendor	✅	✅	✅	✅	✅
Employee	✅	✅	✅	✅	✅
Account	✅	✅	✅	-	✅
Item	✅	✅	✅	✅	✅
Journal Entry	✅	✅	✅	✅	✅
Bill Payment	✅	✅	✅	✅	✅
Purchase	✅	✅	✅	✅	✅
Payment	✅	✅	✅	✅	✅
Sales Receipt	✅	✅	✅	✅	✅
Credit Memo	✅	✅	✅	✅	✅
Refund Receipt	✅	✅	✅	✅	✅
Purchase Order	✅	✅	✅	✅	✅
Vendor Credit	✅	✅	✅	✅	✅
Deposit	✅	✅	✅	✅	✅
Transfer	✅	✅	✅	✅	✅
Time Activity	✅	✅	✅	✅	✅
Class	✅	✅	✅	-	✅
Department	✅	✅	✅	-	✅
Term	✅	✅	✅	-	✅
Payment Method	✅	✅	✅	-	✅
Tax Code	-	✅	-	-	✅
Tax Rate	-	✅	-	-	✅
Tax Agency	-	✅	-	-	✅
Company Info

... View full README on GitHub