mcp-quickbooks

@codespar/mcp-quickbooks

面向 QuickBooks Online（Intuit）的 MCP 服务——这是美国和英国使用最广泛的会计平台，也是全球小型企业 ERP 的默认选择。

这是我们的全球会计支柱。虽然目录涵盖了巴西和拉美的 ERP（Omie、Conta Azul、Alegra、Bling、Tiny），但向国际客户开具发票的拉美 SaaS 公司，以及美国母公司的子公司，几乎都会使用 QuickBooks 记账。

工具（22）

工具	用途
create_customer	在 QuickBooks Online 中创建客户。
update_customer	更新客户。
get_customer	通过 QuickBooks 实体 ID 获取客户。
list_customers	使用 QBO 类 SQL 查询语言查询客户。
create_invoice	创建发票。
update_invoice	更新发票。
void_invoice	作废发票。
delete_invoice	删除发票。
get_invoice	通过 QuickBooks 实体 ID 获取发票。
send_invoice	通过电子邮件向客户发送发票。
create_payment	记录客户针对一张或多张发票的付款。
get_payment	通过 QuickBooks 实体 ID 获取付款。
create_item	创建产品或服务项目。
list_items	使用 QBO 类 SQL 查询语言查询项目。
create_bill	创建账单（应付账款／欠供应商的款项）。
list_bills	使用 QBO 类 SQL 查询语言查询账单。
create_vendor	创建供应商。
list_vendors	使用 QBO 类 SQL 查询语言查询供应商。
create_estimate	创建估价单（报价单）。
create_sales_receipt	创建销售收据（即时付款的销售——合并发票和付款）。
list_accounts	使用 QBO 类 SQL 查询语言查询会计科目表。
get_profit_and_loss_report	按日期范围生成损益报告。

安装

npm install @codespar/mcp-quickbooks

环境

QB_ACCESS_TOKEN="..."   # OAuth2 bearer (expires in 1hr — caller refreshes)
QB_REALM_ID="..."       # company id, issued on authorization
QB_ENV="sandbox"        # or "production". Default: sandbox
QB_MINOR_VERSION="70"   # optional, default 70

身份验证

QuickBooks 使用 OAuth2 authorization_code 流程。访问令牌有效期为 1 小时；刷新令牌有效期为 100 天。本服务假设已签发有效的 QB_ACCESS_TOKEN——令牌获取和刷新由 MCP 脚手架之外的部分负责（通常由 Agent 的凭据管理器处理）。

运行

# stdio (default)
npx @codespar/mcp-quickbooks

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-quickbooks

查询语言

QuickBooks 列表端点使用通过 ?query= 传入的类 SQL 语法。示例：

SELECT * FROM Customer WHERE Active = true MAXRESULTS 50
SELECT * FROM Item WHERE Type = 'Service'
SELECT * FROM Account WHERE AccountType = 'Income'

将完整查询字符串传递给 list_customers、list_items 和 list_accounts。

企业版

需要为 Agent 付款设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、付款路由和合规模板。

许可证

MIT