QuickBooks Online MCP

QuickBooks Online + AI——适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 QuickBooks Online API MCP 服务。 与 Intuit Inc. 无关联，也未获其认可或赞助。

_{▶ 观看 30 秒演示——演示数据为模拟数据；展示的每条命令都存在于实际 CLI 中。}

涵盖 QuickBooks Online Accounting 的所有实体，另含离线 SQLite 镜像、跨实体搜索以及应收账款／应付账款账龄分析；无需 SDK，也无需只读 MCP。适用于你已在使用的 AI——ChatGPT（Plus/Pro+，在此连接器重新发布前暂停使用；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot；也可通过远程方式用于 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在你的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于你的 Agent

安全说明（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本没有密码， 会监听所有网络接口，而且早于浏览器重绑定防护机制， 因此你打开的网页可以访问它。MCP 工具也能使用你的凭据进行更改。 请使用默认的 stdio 传输方式。如果你为远程 Agent 设置了隧道，请将其关闭。 修复即将推出。

MSP 所有者实际使用的六种 Agent（自行安装，即刻可用）：

你的 AI Agent	QuickBooks Online Skill 的安装方式
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 quickbooks-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	在此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式没有密码，会监听所有网络接口，并且你打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 quickbooks-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着要使用此连接器的 HTTP 模式；在连接器重新发布前，该模式将暂停使用：此版本的该模式没有密码，会监听所有网络接口，并且你打开的网页可以访问它。请参阅 mcp-install.md 中的安全说明。

Microsoft 和 Google 技术栈也适用

安装基数很大，但先坦诚说明：这属于远程 / 企业方案，而不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，等待此连接器重新打包：Copilot Studio 需要使用 HTTP 模式，而此版本中的该模式不需要密码，会监听所有网络接口，并且可通过你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 是本地运行的，与 Claude Code 相同。Gemini 应用是远程的，需要使用与 ChatGPT 相同的、目前已暂停的 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也适用）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，也支持 MCP——请参阅下方的安装部分。Cursor、Windsurf、Cline、Continue.dev 和 Zed 也可通过 MCP 使用。各工具的完整接入说明：docs/which-agent.md。

要在多个 Agent 中使用？ 运行一条命令，即可为所有 51+ 个受支持的 Agent 安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行每个 Skill 的安装程序以安装 CLI/MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快捷的安装方式——一键 .mcpb

Claude Desktop 捆绑包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 quickbooks-cli。2026-09-18 起发布的版本已将该 CLI 打包在捆绑包中；较早版本仅包含 MCP 服务，因此如果你的版本缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或者将 QUICKBOOKS_CLI_PATH 设置为现有二进制文件的路径）。详情： #331。

下载 QuickBooks Online MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。只需点击一次，无需 JSON 或 Shell。（在 releases 页面查看所有 QuickBooks Online 版本。）

更喜欢 Claude Code 插件？添加一次市场，然后安装即可立即使用，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install quickbooks@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork：

在此 Agent 工作区中安装 Servosity/msp-skills 中的 QuickBooks Online Skill 和 MCP 服务。如果此工作区使用 POSIX Shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.ps1 | iex。然后按照 README 进行身份验证，并运行 quickbooks-cli --help 进行探索。

这条提示词也适用于任何可运行 Shell 的 Agent。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.sh)

安装程序会将 quickbooks-cli（CLI）和 quickbooks-mcp（MCP 服务）安装到你的用户 bin 路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

quickbooks-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），并在 Settings > Extensions 中重新选择。Claude Code 插件用户：/plugin update quickbooks@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的接入方式——每个 Agent 各有一个章节，其中包括 GitHub Copilot 的 servers 键，以及 Microsoft 365 Copilot / Copilot Studio 的远程接入方式。Claude Desktop 的 Settings > Extensions 面板是最简单的方式；对于偏好编辑 JSON 的用户，mcp-install.md 中记录了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/quickbooks --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/quickbooks --force

Hermes 原生支持 MCP，因此也可以直接使用 quickbooks-mcp 服务——安装方式和环境变量相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/quickbooks 安装 quickbooks 技能。该技能通过 openclaw: frontmatter 块定义其所需 CLI（quickbooks-cli）的安装方式。

OpenClaw 目前尚未普遍开放；frontmatter 接入配置已预先随附，并会在 OpenClaw 发布时立即启用。

进行身份验证

设置 CLI 所需的凭据。你需要两项内容：OAuth 访问令牌 （作用域 com.intuit.quickbooks.accounting）和公司的 realm ID—— 令牌表明你的身份，realm ID 则表明要读取哪家公司。

export QUICKBOOKS_ACCESS_TOKEN=<token>     # from the Intuit OAuth 2.0 Playground, or: quickbooks-cli auth refresh
export QUICKBOOKS_REALM_ID=<company-id>    # your QuickBooks Online company (realm) ID
# optional: export QUICKBOOKS_ENVIRONMENT=sandbox   # default is production
quickbooks-cli doctor

在运行任何会触及数据的操作之前，doctor 会确认凭据和公司作用域有效。即使凭据被拒绝，它也会以状态码 0 退出，因此脚本应添加 --fail-on error。如果你有刷新令牌而非有效的访问令牌，可以使用 quickbooks-cli auth refresh 生成新令牌（设置 QUICKBOOKS_CLIENT_ID、QUICKBOOKS_CLIENT_SECRET 和 QUICKBOOKS_REFRESH_TOKEN）。

此技能的功能

同步一次公司数据，然后即可提问：

MSP 经常问的问题	命令
谁欠我们钱？按 0-30 / 31-60 / 61-90 / 90+ 天分组。	quickbooks-cli ar-aging --agent
我们欠供应商多少钱？何时到期？	quickbooks-cli ap-aging --agent
哪些逾期发票应该优先催收？	quickbooks-cli invoices stale --days 30 --agent
我们在各账户、AR 和 AP 中的现金状况如何？	quickbooks-cli balances --agent
未来 4 周计划中的净现金变动是多少？	quickbooks-cli cash-forecast --weeks 4 --agent
我们的 DSO 是多少？哪些付款方付款最慢？	quickbooks-cli dso --agent
账目是否足够准确，可以在本月结账？	quickbooks-cli reconcile --agent
自上次检查以来，哪些对象的账龄区间发生了变化？	quickbooks-cli aging-delta --agent

完整命令参考： guide.md。有关 AI Agent 操作约定（--agent、--dry-run、何时在修改数据前确认），请参阅 AGENTS.md。

有何不同

大多数 QuickBooks Online 集成和 MCP 服务都会将每个问题转发为一次实时 API 调用。这对于单条记录来说没问题。但到了结账时就行不通了——这时你会问“整本账里哪些款项逾期，90+ 天区间的金额是多少”，因为 QuickBooks 没有任何单一端点能返回账龄、DSO 或对账结论。

此技能会将 QuickBooks Online 同步到带有全文搜索的本地 SQLite 镜像中。聚合类问题只需执行一次本地 SQL 联接：响应迅速、可离线使用，而且 AI 看到的是答案，而非原始数据。ar-aging、dso 和 reconcile 等组合命令会使用真实日期计算，跨发票、付款、客户和供应商进行联接——无状态 API 封装器无法做到这一点。

它解决的痛点

问任何一位 MSP 业主，月底最后一天最耗时间的是什么，答案都是做账。在 r/msp 和 r/QuickBooks 上，同样的抱怨反复出现：月结拖延，是因为你要追查未核销的收款、合并“Acme Inc”和“Acme, Inc.”，还要在把账簿交给会计师之前证明账目平衡。应收账款悄然逾期——等你导出 A/R Aging Summary 时，90 天以上账龄区间里已经积压了一堆难以收回的款项；而且 QuickBooks 报表反映的是某个时间点的情况，如果不自己保留电子表格历史记录，你就无法看出哪些款项从上个月起又跨入了新的账龄区间。

这个技能将每项繁琐工作变成一个离线问题：

繁琐工作	命令
无需导出再制作数据透视表，即可查看哪些款项已逾期	quickbooks-cli ar-aging --agent
整理本周的催收电话清单	quickbooks-cli invoices stale --days 30 --agent
执行整套月末结账检查	quickbooks-cli reconcile --agent
查找重复的客户／供应商记录	quickbooks-cli dupes customers --agent
查看自上次检查以来账龄发生了哪些变化	quickbooks-cli aging-delta --agent

更详细的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

当前版本不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着需要以 HTTP 模式运行 QuickBooks Online MCP 服务。当前版本的 HTTP 模式无需密码即可运行，会监听所有网络接口，并且可被你打开的网页访问，因此在重新发布连接器之前，请勿运行该模式或将其置于隧道之后；原因见 mcp-install.md 中的安全说明。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这能与 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 配合使用吗？

可以——它们都支持 MCP。跨工具安装命令见上方矩阵，深入说明请参阅 docs/which-agent.md。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是按操作系统使用一行安装命令（bash 或 PowerShell）。这两种方式都无需编写代码。你只需输入一次 QuickBooks Online 凭据。

我的 QuickBooks Online 数据安全吗？

你的数据留在自己的计算机上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在你用户账户目录下的一个文件夹中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从你的环境或 Agent 配置中读取；MSP Skills 不会将凭据打包进此代码库，也不会将其传输到任何地方。

这会触发 QuickBooks API 速率限制吗？

很少。唯一会大量调用 API 的步骤是首次执行 sync，将公司数据镜像到本地 SQLite；此后，ar-aging、dso、cash-forecast、reconcile 等命令都会完全离线地对镜像进行操作。Intuit 按公司（realm）实施限流，而 CLI 会为你处理同步的分页和速率限制，因此日常查询不会访问 API。

我需要成为 Intuit 合作伙伴才能使用吗？

不需要。你需要一个 QuickBooks Online 公司账户、一个作用域为 com.intuit.quickbooks.accounting 的 OAuth 访问令牌，以及你的公司 realm ID。你可以从 Intuit Developer 门户或 OAuth 2.0 Playground 获取令牌；quickbooks-cli auth refresh 会将刷新令牌换成新的访问令牌。无需合作伙伴身份。

这会取代我的 QuickBooks Online 门户吗？

不会——它是门户的补充。QuickBooks 仍是你的记账系统；此技能可让你通过终端或 AI Agent 获取答案，保留门户不具备的跨运行账龄记录，并一次性组合出需要你在界面中手动整理的月末 reconcile。写入操作会通过门户使用的同一个 Accounting API 完成。

费用是多少？

免费。采用 Apache-2.0 许可证。你只需为所使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 服务提供商收取，而不是由我们收取。

安全模型

层级	示例	建议的 Agent 策略
读取	ar-aging、ap-aging、balances、dso、cash-forecast、reconcile、dupes、search，以及所有 list / get	允许
写入（常规）	invoices / bills / payments / customers / vendors / accounts / items / journal-entries 的 create 和 update（16 条命令），以及批量 import	使用 --dry-run 预览，再经审核后写入
破坏性操作 / 配置	invoices delete、bills delete、payments delete、journal-entries delete（硬删除）	仅限人在环中操作

最有力的控制措施是你授予 QuickBooks Online 凭据的权限范围——CLI 只能执行凭据允许的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

已在实际环境中验证。Servosity（维护者）已在其生产租户中确认。更多 MSP 正在我们的每周 Build Sessions 中实际运行该工具。请在 compoundingteams.com/build-sessions 回复确认参加。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已准备好支持 OpenClaw（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可证。使用 CLI Printing Press 构建。最后更新：2026-06-06。