← 返回目录

QuickBooks Online MCP Server

官方

通过 MCP 访问 QuickBooks Online 数据与财务操作。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 215 / 230
Stars: ★ 418 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 26 天前
工具数: 100

32FMRS · D

功能覆盖广，提供 145 个工具、29 类实体和 11 类报表；但安装依赖 Intuit 应用注册与 OAuth 流程，并应核对源资料中不一致的许可证声明。

最强项 · 文档质量 8/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

7/20

维护活跃度

6/20

文档质量

8/20

安装易用性

7/20

查看各项评分依据

可靠性 4/20: 仅提供README，未提供可审查的源码、服务器清单、CI工作流或已提交测试；README声称有145个工具、396个测试和100%覆盖率，但这些声明无法静态核验。工具声明与实际行为、初始化握手、依赖控制和错误路径均缺乏证据，因此只能给出较低分。
安全与权限 7/20: 证据显示使用OAuth 2.0，并支持通过环境变量配置凭据、禁用写入/更新/删除工具，且默认以本地stdio运行，这些是正面信号。扣分原因是提供广泛的财务读写、作废和删除能力，但未见逐次确认、细粒度账户范围、租户隔离实现或敏感数据输出控制；凭据及刷新令牌写入环境文件，令牌轮换和PDF落盘路径也缺少可审查实现。未发现足以触发红线的明确证据。
维护活跃度 6/20: 仓库标为未归档，且有Apache-2.0元数据许可，但仅有星数和开放问题数，未提供提交历史、发布记录、依赖更新、维护者响应或安全报告渠道。README又称MIT许可，形成许可信息矛盾，降低维护与治理可信度。
文档质量 8/20: README覆盖安装、OAuth、客户端配置、工具分类、报告、常见故障和本地运行限制，信息量较高。扣分原因是没有工具参数/schema证据、成本和API限制说明不足，生产OAuth流程较脆弱，克隆地址使用your-username占位符，且许可和工具总数等内容存在未核验或矛盾陈述。
安装易用性 7/20: README给出了Node构建、环境变量、Claude Code配置和沙箱/生产OAuth步骤，具备可操作性。扣分原因是必须注册Intuit应用、完成浏览器授权并管理刷新令牌；生产环境需要公开HTTPS回调或ngrok，安装示例仓库地址还是占位符，且未提供已发布包或跨平台验证证据。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要 QuickBooks Online 数据访问或财务操作的开发者
使用 Claude Code 或其他 MCP 兼容客户端的本地集成
需要沙盒测试或生产公司连接的团队

不适合谁

不使用 QuickBooks Online 的用户
无法完成 Intuit 应用注册和 OAuth 授权的用户
需要无需本地进程或无需凭据配置的托管服务的团队

所需权限

需要 Intuit OAuth 2.0 应用凭据
需要连接 QuickBooks Online 公司及其 Realm ID
根据启用的工具，可能需要读取、创建、更新和删除财务数据的权限

风险与副作用

写入、更新和删除工具可能改变或作废财务记录
刷新令牌会自动轮换并被写回配置文件
生产 OAuth 初始授权需要公开 HTTPS 回调
源资料中的仓库许可证信息存在 Apache-2.0 与 README MIT 不一致

安装接入

准备工作

运行环境：Node.js

QUICKBOOKS_CLIENT_ID 必填 Intuit 开发者门户中创建应用的 Client ID，必需，非机密。

QUICKBOOKS_CLIENT_SECRET 必填密钥同一应用 Keys & Credentials 页面提供的 Client Secret，必需，机密。

QUICKBOOKS_REFRESH_TOKEN 必填密钥通过 npm run auth 完成 OAuth 授权后获得的刷新令牌，必需，机密。

QUICKBOOKS_REALM_ID 必填目标 QuickBooks 公司（沙盒或生产）的 Realm ID，必需，非机密。

QUICKBOOKS_ENVIRONMENT 必填设为 sandbox 或 production，决定连接的环境。

其他可选配置项（5 个）

QUICKBOOKS_DISABLE_WRITE 可选设为 true 时禁止注册 create_* 工具，可选。

QUICKBOOKS_DISABLE_UPDATE 可选设为 true 时禁止注册 update_* 工具，可选。

QUICKBOOKS_DISABLE_DELETE 可选设为 true 时禁止注册 delete_* 工具，可选。

QUICKBOOKS_TOKEN_STORE_PATH 可选只读文件系统或每租户隔离场景下，指向可写的绝对路径令牌存储文件；必须设置在宿主进程环境变量中。

QBO_PDF_OUTPUT_DIR 可选设置后 get_invoice_pdf 会将 PDF 写入该目录，而不是以 base64 内联返回。

克隆仓库，运行 npm install 和 npm run build。复制根目录的 .env.example 为 .env，并填写 QuickBooks OAuth 客户端凭据、刷新令牌、Realm ID 和环境。首次使用需在 Intuit Developer Portal 注册应用并完成浏览器 OAuth 流程；沙盒可使用 localhost 回调，生产环境需要公开 HTTPS 回调。将服务器配置为运行 dist/index.js 的 node stdio 子进程。

.mcp.json

{"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","QUICKBOOKS_DISABLE_WRITE":"false","QUICKBOOKS_DISABLE_UPDATE":"false","QUICKBOOKS_DISABLE_DELETE":"false"}}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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",
        "QUICKBOOKS_DISABLE_WRITE": "false",
        "QUICKBOOKS_DISABLE_UPDATE": "false",
        "QUICKBOOKS_DISABLE_DELETE": "false"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add quickbooks -e QUICKBOOKS_CLIENT_ID=your_client_id -e QUICKBOOKS_CLIENT_SECRET=your_client_secret -e QUICKBOOKS_REFRESH_TOKEN=your_refresh_token -e QUICKBOOKS_REALM_ID=your_realm_id -e QUICKBOOKS_ENVIRONMENT=sandbox -e QUICKBOOKS_DISABLE_WRITE=false -e QUICKBOOKS_DISABLE_UPDATE=false -e QUICKBOOKS_DISABLE_DELETE=false -- node path/to/mcp-quickbooks-online/dist/index.js

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动后，检查客户端工具列表中是否出现 get_invoice、search_customers 和 get_profit_and_loss 等工具；随后用 search_customers 发起一次查询，若能返回 QuickBooks 沙盒公司中的客户数据，即证明连接成功。

常见排障

检查所有环境变量是否正确设置
确认刷新令牌未过期且 OAuth 凭据有效
确认 Intuit 中登记的回调 URI 与实际 URI 完全一致
沙盒连接应使用 QUICKBOOKS_ENVIRONMENT=sandbox
只读文件系统中使用 QUICKBOOKS_TOKEN_STORE_PATH 指向绝对路径的可写令牌文件

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索上个月金额超过 1000 美元的发票并汇总结果。
为新客户创建一条客户记录，然后查询该客户的当前余额。
生成损益表和资产负债表报告。
下载最近一张发票的 PDF 并保存到磁盘。

工具能力 100

create_customer 写入

创建客户

get_customer 只读

按 ID 获取客户

update_customer 写入

更新客户信息

delete_customer 破坏性

删除客户

search_customers 只读

按筛选条件搜索客户

create_invoice 写入

创建发票

get_invoice 只读

按 ID 获取发票

update_invoice 写入

更新发票信息

展开其余 92 个工具

delete_invoice 破坏性

删除或作废发票

search_invoices 只读

按筛选条件搜索发票

get_invoice_pdf 只读

下载发票 PDF

create_estimate 写入

创建估算单

get_estimate 只读

按 ID 获取估算单

update_estimate 写入

更新估算单

delete_estimate 破坏性

删除估算单

search_estimates 只读

搜索估算单

create_bill 写入

创建账单

get_bill 只读

按 ID 获取账单

update_bill 写入

更新账单

delete_bill 破坏性

删除账单

search_bills 只读

搜索账单

create_vendor 写入

创建供应商

get_vendor 只读

按 ID 获取供应商

update_vendor 写入

更新供应商

delete_vendor 破坏性

删除供应商

search_vendors 只读

搜索供应商

create_employee 写入

创建员工

get_employee 只读

按 ID 获取员工

update_employee 写入

更新员工

delete_employee 破坏性

删除员工

search_employees 只读

搜索员工

create_account 写入

创建账户

get_account 只读

按 ID 获取账户

update_account 写入

更新账户

search_accounts 只读

搜索账户

create_item 写入

创建项目

get_item 只读

按 ID 获取项目

update_item 写入

更新项目

delete_item 破坏性

删除项目

search_items 只读

搜索项目

create_journal_entry 写入

创建日记账分录

get_journal_entry 只读

按 ID 获取日记账分录

update_journal_entry 写入

更新日记账分录

delete_journal_entry 破坏性

删除日记账分录

search_journal_entries 只读

搜索日记账分录

create_bill_payment 写入

创建账单付款

get_bill_payment 只读

按 ID 获取账单付款

update_bill_payment 写入

更新账单付款

delete_bill_payment 破坏性

删除账单付款

search_bill_payments 只读

搜索账单付款

create_purchase 写入

创建采购记录

get_purchase 只读

按 ID 获取采购记录

update_purchase 写入

更新采购记录

delete_purchase 破坏性

删除采购记录

search_purchases 只读

搜索采购记录

create_payment 写入

记录客户付款

get_payment 只读

按 ID 获取付款

update_payment 写入

更新付款

delete_payment 破坏性

作废付款

search_payments 只读

搜索付款

create_sales_receipt 写入

创建销售收据

get_sales_receipt 只读

按 ID 获取销售收据

update_sales_receipt 写入

更新销售收据

delete_sales_receipt 破坏性

作废销售收据

search_sales_receipts 只读

搜索销售收据

create_credit_memo 写入

创建贷项通知单

get_credit_memo 只读

按 ID 获取贷项通知单

update_credit_memo 写入

更新贷项通知单

delete_credit_memo 破坏性

作废贷项通知单

search_credit_memos 只读

搜索贷项通知单

create_refund_receipt 写入

创建退款收据

get_refund_receipt 只读

按 ID 获取退款收据

update_refund_receipt 写入

更新退款收据

delete_refund_receipt 破坏性

作废退款收据

search_refund_receipts 只读

搜索退款收据

create_purchase_order 写入

创建采购订单

get_purchase_order 只读

按 ID 获取采购订单

update_purchase_order 写入

更新采购订单

delete_purchase_order 破坏性

删除采购订单

search_purchase_orders 只读

搜索采购订单

create_vendor_credit 写入

创建供应商贷项

get_vendor_credit 只读

按 ID 获取供应商贷项

update_vendor_credit 写入

更新供应商贷项

delete_vendor_credit 破坏性

删除供应商贷项

search_vendor_credits 只读

搜索供应商贷项

create_deposit 写入

创建银行存款

get_deposit 只读

按 ID 获取存款

update_deposit 写入

更新存款

delete_deposit 破坏性

删除存款

search_deposits 只读

搜索存款

create_transfer 写入

创建账户转账

get_transfer 只读

按 ID 获取转账

update_transfer 写入

更新转账

delete_transfer 破坏性

删除转账

search_transfers 只读

搜索转账

create_time_activity 写入

创建工时记录

get_time_activity 只读

按 ID 获取工时记录

update_time_activity 写入

更新工时记录

delete_time_activity 破坏性

删除工时记录

search_time_activities 只读

搜索工时记录

使用场景

查询客户、发票、账单和付款数据

创建和更新 QuickBooks Online 财务记录

获取资产负债表、损益表和现金流量表等报表

通过 MCP 为 AI 应用提供实时 QuickBooks Online 数据

支持客户端

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

QuickBooks Online MCP Server 通过标准 Model Context Protocol 接口向 AI 助手提供 QuickBooks Online 集成。它支持 29 类实体的创建、读取、更新、删除和搜索，以及 11 类财务报表，并以本地 stdio 子进程运行。