Quickbooks Mcp Server

🧾 QuickBooks MCP サーバー

Claude Desktop 内で自然言語を使って QuickBooks のデータを照会できる、安全性を重視したローカルファーストの Model Context Protocol（MCP）サーバーです。

---

✅ MCP Review 認定

この MCP サーバーは 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 を起動し、「設定」>「開発者」>「設定を編集」に移動します。
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 を起動するたびに、最新の QuickBooks API ツールが AI アシスタントから利用できるようになります。

ステップ 3. Claude Desktop を起動して、アシスタントに作業を手伝ってもらう

例

勘定科目の照会

Get all accounts from QuickBooks.

請求書の照会

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

顧客の照会

Get all customers from QuickBooks.