本页由 AI 翻译，技术细节请以原文为准。 查看原文
QuickBooks Online MCP server rebuilt on Cloudflare Workers with OAuth 2.0, typed Zod schemas, and Streamable HTTP/SSE transport. Drop-in compatible with LibreChat and other MCP clients.
概览
A Model Context Protocol server for QuickBooks Online, built on Cloudflare Workers with OAuth 2.0 authentication. Provides 55 tools for managing QuickBooks entities (customers, invoices, bills, vendors, etc.) via any MCP-compatible client. - runtime with Durable Objects for MCP state - for HTTP routing and OAuth proxy - (from agents package) for MCP transport (SSE + Streamable HTTP) - calls to the QuickBooks REST API — no Node.js SDKs required The Intuit Developer sandbox is — no QuickBooks subscription needed for testing. 1. Go to developer.intuit.com and sign up (no credit card required) 2. Once registered, Intuit automatically creates a with sample data 1. After logging in, go to 2. Click 3. Select 4. Name it anything (e.g. "QBO MCP Server") 5. Select the scope 6. Click 1. Inside your app, click in the left nav 2. Make sure you're on the tab (not Production) 3. Click 4. Copy your and 1. Scroll to 2. Click 3. Add the redirect URI for your MCP client (see table below) 4. Save
README
以下为原文 README 节选，完整内容请查看原文。
QuickBooks Online MCP Server
A Model Context Protocol server for QuickBooks Online, built on Cloudflare Workers with OAuth 2.0 authentication.
Provides 55 tools for managing QuickBooks entities (customers, invoices, bills, vendors, etc.) via any MCP-compatible client.
Architecture
- Cloudflare Workers runtime with Durable Objects for MCP state
- Hono for HTTP routing and OAuth proxy
- McpAgent (from
agentspackage) for MCP transport (SSE + Streamable HTTP) - Pure
fetch()calls to the QuickBooks REST API — no Node.js SDKs required
api/
├── index.ts # Hono app: OAuth discovery, /register, /authorize, /token, MCP routes
├── QuickBooksMCP.ts # McpAgent Durable Object with all tools
├── QuickBooksService.ts # Fetch-based QB API client (generic CRUD + query builder)
└── lib/
└── qb-auth.ts # OAuth middleware and token exchange helpers
Getting Your Intuit Developer Credentials
The Intuit Developer sandbox is completely free — no QuickBooks subscription needed for testing.
Step 1: Create a Free Developer Account
- Go to developer.intuit.com and sign up (no credit card required)
- Once registered, Intuit automatically creates a sandbox company with sample data
Step 2: Create an App
- After logging in, go to My Hub > App Dashboard
- Click Create an app
- Select QuickBooks Online and Payments
- Name it anything (e.g. “QBO MCP Server”)
- Select the
com.intuit.quickbooks.accountingscope - Click Create app
Step 3: Get Your Client ID and Client Secret
- Inside your app, click Keys & OAuth in the left nav
- Make sure you’re on the Development tab (not Production)
- Click Show credentials
- Copy your Client ID and Client Secret
Step 4: Add the Redirect URI
Still in Keys & OAuth:
- Scroll to Redirect URIs
- Click Add URI
- Add the redirect URI for your MCP client (see table below)
- Save
| MCP Client | Redirect URI |
|---|---|
| LibreChat (Docker or local) | http://localhost:3080/api/mcp/quickbooks/oauth/callback |
| MCP Inspector | Use the callback URL shown in the Inspector UI |
Setup
1. Install dependencies
npm install
2. Configure secrets
Copy the template and fill in your credentials from the steps above:
cp .dev.vars.template .dev.vars
QUICKBOOKS_CLIENT_ID=your_client_id
QUICKBOOKS_CLIENT_SECRET=your_client_secret
QUICKBOOKS_REALM_ID=your_company_id # Optional if passed via header
QUICKBOOKS_ENVIRONMENT=sandbox # 'sandbox' or 'production'
3. Start the server
npx wrangler dev
The server starts at http://localhost:3000.
4. Verify
# Health check
curl http://localhost:3000/
# OAuth discovery
curl http://localhost:3000/.well-known/oauth-authorization-server
MCP Client Configuration
LibreChat
安装
npx wrangler dev