Mcp Quickbooks

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Nov 3, 2026

MCP server for QuickBooks Online (Intuit) — customers, invoices, payments, items, accounts, P&L

已验证STDIO仅桌面金融数据与分析商业与电商

概览

AI 生成的概览

面向 QuickBooks Online 的 MCP 服务器，让助手管理客户、发票、付款、账单、商品与科目，并获取损益表。

可以做什么
  • 创建、更新和查询客户、供应商与商品
  • 创建、更新、作废、删除、发送和获取发票
  • 记录并查询客户付款，创建销售收据与报价单
  • 创建和列出账单，列出会计科目表
  • 按日期区间生成损益表
  • 使用 QuickBooks 类 SQL 查询语句检索列表接口
适用场景
适合让助手直接操作公司的 QuickBooks Online 账务：起草并发送发票、登记收款、管理客户与供应商，或在对话中直接获取损益表。
运行要求
以 npm 包形式在本地通过 stdio 运行（需要 Node.js）。需要 QB_ACCESS_TOKEN（OAuth2 持有者令牌，约一小时过期，需在服务器之外刷新）和 QB_REALM_ID（公司 ID）。可选 QB_ENV 选择 sandbox（默认）或 production，QB_MINOR_VERSION 默认 70。需要访问 Intuit API 的网络连接。
安装前请注意
服务器持有可访问公司账务数据的 QuickBooks 访问令牌，令牌获取与刷新由调用方负责。多个工具会写入、发送、作废或删除财务记录，包括向客户发送发票邮件，且 QB_ENV 可指向生产账套。在允许助手操作真实数据前请先评估。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Quickbooks，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-quickbooks

MCP server for QuickBooks Online (Intuit) — the most-used accounting platform in the US and UK, and the global default for small-business ERP.

This is our global accounting anchor. While the catalog covers BR/LatAm ERPs (Omie, Conta Azul, Alegra, Bling, Tiny), LatAm SaaS companies that invoice international customers — or subsidiaries of US parent companies — almost universally keep their books in QuickBooks.

Tools (22)

ToolPurpose
create_customerCreate a customer in QuickBooks Online.
update_customerUpdate a customer.
get_customerRetrieve a customer by QuickBooks entity id.
list_customersQuery customers using QBO's SQL-like query language.
create_invoiceCreate an invoice.
update_invoiceUpdate an invoice.
void_invoiceVoid an invoice.
delete_invoiceDelete an invoice.
get_invoiceRetrieve an invoice by QuickBooks entity id.
send_invoiceEmail an invoice to the customer.
create_paymentRecord a customer payment against one or more invoices.
get_paymentRetrieve a payment by QuickBooks entity id.
create_itemCreate a product or service item.
list_itemsQuery items using QBO's SQL-like query language.
create_billCreate a bill (AP / money owed to a vendor).
list_billsQuery bills using QBO's SQL-like query language.
create_vendorCreate a vendor (supplier).
list_vendorsQuery vendors using QBO's SQL-like query language.
create_estimateCreate an estimate (quote).
create_sales_receiptCreate a sales receipt (paid-on-the-spot sale — combines invoice + payment).
list_accountsQuery the chart of accounts using QBO's SQL-like query language.
get_profit_and_loss_reportRun a Profit and Loss report for a date range.

Install

bash
npm install @codespar/mcp-quickbooks

Environment

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

Authentication

QuickBooks uses OAuth2 authorization_code flow. Access tokens live 1hr; refresh tokens 100 days. This server assumes a valid QB_ACCESS_TOKEN is already issued — token acquisition and refresh live outside the MCP scaffold (typically in your agent's credential manager).

Run

bash
# stdio (default)npx @codespar/mcp-quickbooks
# HTTPMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-quickbooks

Query language

QuickBooks list endpoints use a SQL-like syntax passed via ?query=. Examples:

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

Pass the full query string to list_customers, list_items, list_accounts.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

来源：packages/erp/quickbooks/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分