QuickBooks Desktop

quickbooks-mcp

开源的 MCP 服务，可将 QuickBooks Desktop（Pro、Premier、Enterprise）连接到大模型和 Agent。

状态：1.0 之前的版本。目前已使用 Intuit 的示例公司文件在 QuickBooks Desktop Enterprise Accountant 24.0 上进行测试；其他版本和年份尚未测试（请参阅 COMPATIBILITY.md，如果你能帮忙，也请参阅测试人员指南）。

你将获得

• 读取： 客户、供应商、员工、项目、账户、发票、账单、付款、库存、时间、自定义字段，以及所有标准报告（账龄、损益表、资产负债表……），并以简洁表格呈现。
• 仅在你允许时更改： 创建、更新、删除和作废，支持预览、确认令牌、幂等键、批次和审计日志。
• 默认安全： 只读，税号、银行账号和卡号会被屏蔽，薪资功能关闭，绝不接受卡片数据。
• 本地运行： 在你的 Windows 电脑上与 QuickBooks 一起运行，并通过其 SDK 与之通信。无云端、无遥测。

安装

Claude Desktop	打开最新版本中的 .mcpb
Claude Code	/plugin marketplace add devwithmj/quickbooks-mcp，然后运行 /plugin install quickbooks-desktop@quickbooks-mcp
npx	npx -y @devwithmj/quickbooks-mcp
dnx	dnx DevWithMJ.QuickBooks.Mcp --yes
exe	从发布页面获取 quickbooks-mcp-win-x64.exe（或 -win-x86）

然后在 QuickBooks 中允许访问一次（--authorize），并将服务添加到你的 AI 应用中。分步说明：docs/GUIDE.md。

软件包和目录页面：npm、NuGet、GitHub 发布页面、官方 MCP Registry（io.github.devwithmj/quickbooks-mcp）以及 Glama。

启用更改

除非你主动选择启用，否则所有功能均为只读。在 MCP 客户端启动服务时传入的参数中添加该标志：

"args": ["-y", "@devwithmj/quickbooks-mcp", "--allow-writes"]

也可以设置环境变量：QB_ALLOW_WRITES=true 可启用所有更改，或设置 QB_ENABLE_WRITE、QB_ENABLE_UPDATE 和 QB_ENABLE_DELETE，分别启用一种更改类型（QB_WRITE_ALLOW=Invoice,Customer 可限制允许更改的记录类型）。删除和作废始终需要确认步骤。详情请参阅：docs/WRITES.md。

通过 HTTP 使用（高级）

大多数客户端会自行启动服务。对于无法自行启动服务的客户端，quickbooks-mcp --http 仅在 127.0.0.1:8765 上通过 HTTP 提供 MCP 服务，并且每个请求都需要访问密钥（启动时会打印，或通过 QB_HTTP_KEY 设置）。除非同时传入 --http-allow-writes，否则更改功能仍保持关闭。如需从其他设备访问，请在其前方配置你自己的隧道：docs/REMOTE-ACCESS.md。

QuickBooks Online 还是 Desktop？

本项目适用于 QuickBooks Desktop。如果你使用 QuickBooks Online，请使用 Intuit 自家的服务：intuit/quickbooks-online-mcp-server（Apache-2.0）。我们参考了它的设计思路，并编写了自己的代码；没有复制任何代码。

	QuickBooks Online 服务（Intuit）	本项目（Desktop）
适用产品	QuickBooks Online	QuickBooks Desktop Pro、Premier、Enterprise（Windows）
运行位置	通过 Intuit 的云 API 通信	在你的电脑上，运行于 QuickBooks 旁，通过其本地 SDK
设置和登录	Intuit 开发者应用和 OAuth	在 QuickBooks 中一次性批准“允许此应用”（--authorize）；无需开发者账户
仅 Desktop 支持		库存装配件和站点、价格等级、工伤赔偿代码、通过数据扩展实现的自定义字段、在 QuickBooks 窗口中打开记录
仅 Online 支持	附件、发票 PDF 及其他云功能
默认安全措施	查看该项目	默认只读，启用写入前需手动开启；删除和作废操作需经你批准；敏感数字会被遮盖；禁用工资单功能；保留审计日志
数据流向	经由 Intuit 的云	数据保留在你的电脑上，助手看到的内容除外

两者不共用公司文件或账户：使用 Online 的企业不应使用本项目，使用 Desktop 的企业也无法使用 Intuit 的服务。

要求

• 安装并获得许可的 QuickBooks Desktop，以及 Windows。
• 对公司文件拥有管理员权限，以完成一次性授权。

不适用于 QuickBooks Online（Intuit 有自己的 MCP 服务）、QuickBooks for Mac（没有 SDK）、银行卡处理或作为 Windows 服务运行。请参阅 docs/SCOPE.md。

文档

• 用户指南：安装、授权、连接客户端、故障排除、常见问题
• 工具：每个工具、参数和示例
• 提示词手册、写入和报表
• 范围与非目标和安全模型
• 路线图和1.0 检查清单
• 支持、升级和卸载、兼容性、性能
• 从源代码构建、发布、测试、贡献

法律声明

本项目与 Intuit 无关联，也未获其认可。请参阅 NOTICE.md。

许可证

MIT