用途:将 QuickBooks Online API 封装为 Model Context Protocol 服务器,让 Claude 等 AI 助手通过 144 个标准化工具访问会计数据。
主要能力:29 类实体(客户、发票、账单、供应商、付款等)的创建、读取、更新、删除与搜索;11 种财务报表,如资产负债表、损益表、现金流量表、应收账龄、总账;OAuth 2.0 令牌管理与自动刷新;Zod 模式校验;支持沙箱与生产环境。
安装:git clone https://github.com/intuit/quickbooks-online-mcp-server.git,然后 cd quickbooks-online-mcp-server、npm install、npm run build。在项目根目录创建 .env,配置 QUICKBOOKS_CLIENT_ID、QUICKBOOKS_CLIENT_SECRET、QUICKBOOKS_ENVIRONMENT、QUICKBOOKS_REFRESH_TOKEN、QUICKBOOKS_REALM_ID。在 Claude Desktop 的 MCP 配置文件中加入 command 为 node、args 指向 dist/index.js 的服务器项,重启生效。
OAuth:需在 developer.intuit.com 创建应用获取 Client ID 与 Secret,设置重定向 URI,完成一次 OAuth 流程获取 refresh token,作用域为 com.intuit.quickbooks.accounting。
用法:实体操作采用 use_mcp_tool 调用;搜索使用类 SQL 查询,如 SELECT * FROM Customer WHERE Active = true MAXRESULTS 100;更新必须携带当前 SyncToken,否则返回 400;稀疏更新需 sparse: true;日期格式为 YYYY-MM-DD;报表工具接收日期范围、核算方式等参数。
限制:使用前必须准备有效的 Intuit 开发者凭据与 refresh token;更新前需先获取实体以取得 SyncToken;生产环境重定向需 HTTPS 公网地址,localhost 被拒绝;具体收费、工具完整清单及未提及的实体类型暂未提供。