适合谁
- 需要 QuickBooks Online 数据访问或财务操作的开发者
- 使用 Claude Code 或其他 MCP 兼容客户端的本地集成
- 需要沙盒测试或生产公司连接的团队
Q
32FMRS · D
功能覆盖广，提供 145 个工具、29 类实体和 11 类报表；但安装依赖 Intuit 应用注册与 OAuth 流程，并应核对源资料中不一致的许可证声明。
QuickBooks Online MCP Server 通过标准 Model Context Protocol 接口向 AI 助手提供 QuickBooks Online 集成。它支持 29 类实体的创建、读取、更新、删除和搜索，以及 11 类财务报表，并以本地 stdio 子进程运行。
工具能力
create_customer
创建客户
get_customer
按 ID 获取客户
update_customer
更新客户信息
delete_customer
删除客户
search_customers
按筛选条件搜索客户
create_invoice
创建发票
get_invoice
按 ID 获取发票
update_invoice
更新发票信息
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
搜索工时记录
安装接入
克隆仓库，运行 npm install 和 npm run build。复制根目录的 .env.example 为 .env，并填写 QuickBooks OAuth 客户端凭据、刷新令牌、Realm ID 和环境。首次使用需在 Intuit Developer Portal 注册应用并完成浏览器 OAuth 流程；沙盒可使用 localhost 回调，生产环境需要公开 HTTPS 回调。将服务器配置为运行 dist/index.js 的 node stdio 子进程。
claude_desktop_config.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"}}}}
选型与风险
不适合谁
- 不使用 QuickBooks Online 的用户
- 无法完成 Intuit 应用注册和 OAuth 授权的用户
- 需要无需本地进程或无需凭据配置的托管服务的团队
所需权限
- 需要 Intuit OAuth 2.0 应用凭据
- 需要连接 QuickBooks Online 公司及其 Realm ID
- 根据启用的工具，可能需要读取、创建、更新和删除财务数据的权限
风险与副作用
- 写入、更新和删除工具可能改变或作废财务记录
- 刷新令牌会自动轮换并被写回配置文件
- 生产 OAuth 初始授权需要公开 HTTPS 回调
- 源资料中的仓库许可证信息存在 Apache-2.0 与 README MIT 不一致
常见排障
- 检查所有环境变量是否正确设置
- 确认刷新令牌未过期且 OAuth 凭据有效
- 确认 Intuit 中登记的回调 URI 与实际 URI 完全一致
- 沙盒连接应使用 QUICKBOOKS_ENVIRONMENT=sandbox
- 只读文件系统中使用 QUICKBOOKS_TOKEN_STORE_PATH 指向绝对路径的可写令牌文件
使用场景
查询客户、发票、账单和付款数据
创建和更新 QuickBooks Online 财务记录
获取资产负债表、损益表和现金流量表等报表
通过 MCP 为 AI 应用提供实时 QuickBooks Online 数据
支持客户端
Claude Code完整支持