Quickbooks Mcp Server

🧾 QuickBooks MCP 服务

一个安全、本地优先的模型上下文协议（MCP）服务，可在 Claude Desktop 中通过自然语言查询 QuickBooks 数据。

---

✅ MCP Review 认证

此 MCP 服务已通过 MCP Review 认证：MCP Review 认证页面。

在 MCP Review 上列出并获得认证，意味着此服务遵循 MCP 标准和最佳实践，并受到开发者社区的信任。

---

要求：

1. Python 3.10 或更高版本

环境配置

如需本地开发，请在项目根目录中创建 .env 文件，并填入 QuickBooks 凭据：

# Copy the template and fill in your actual credentials
cp env_template.txt .env

然后编辑 .env 文件，填入实际的 QuickBooks API 凭据：

QUICKBOOKS_CLIENT_ID=your_actual_client_id
QUICKBOOKS_CLIENT_SECRET=your_actual_client_secret
QUICKBOOKS_REFRESH_TOKEN=your_actual_refresh_token
QUICKBOOKS_COMPANY_ID=your_actual_company_id
QUICKBOOKS_ENV='sandbox' or 'production'

注意： 出于安全考虑，.env 文件会被 git 自动忽略。

步骤 1. 安装 uv：

• MacOS/Linux：curl -LsSf https://astral.sh/uv/install.sh | sh
• Windows：powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

步骤 2. 配置 Claude Desktop

1. 下载 Claude Desktop。
2. 启动 Claude，然后依次前往 Settings > Developer > Edit Config。
3. 修改 claude_desktop_config.json，内容如下：

{
  "mcpServers": {
    "QuickBooks": {
      "command": "uv",
      "args": [
        "--directory",
        "<absolute_path_to_quickbooks_mcp_folder>",
        "run",
        "main_quickbooks_mcp.py"
      ]
    }
  }
}

4. 重新启动 Claude Desktop。

首次使用这些设置打开 Claude Desktop 时，由于需要安装必需的软件包并下载最新的 QuickBooks API 文档，QuickBooks 工具可能需要 10–20 秒才会显示在界面中。

每次启动 Claude Desktop，都会向 AI 助手提供最新的 QuickBooks API 工具。

步骤 3. 启动 Claude Desktop，让助手为你提供帮助

示例

查询账户

Get all accounts from QuickBooks.

查询账单

Get all bills from QuickBooks created after 2024-01-01.

查询客户

Get all customers from QuickBooks.