QuickBooks Online

@mindstone/mcp-server-quickbooks

Model Context Protocol ホスト向けの QuickBooks Online MCP サーバーです。標準化された MCP インターフェースを通じて、QuickBooks Online の請求書、請求、顧客、仕入先、従業員、勘定科目を管理できます。

ステータス

• バージョン： 0.4.3 · npm
• 認証： OAuth（QUICKBOOKS_REFRESH_TOKEN）
• ツール： 21（顧客、仕入先、請求書、請求、見積もり、レポート）
• 対象： クラウド API
• 機械可読： STATUS.json

本番環境への書き込みはデフォルトで有効です

QuickBooks を変更するすべてのツール （create_quickbooks_invoice、create_quickbooks_bill、 create_quickbooks_customer、create_quickbooks_vendor、 create_quickbooks_estimate、send_quickbooks_invoice_email、 update_quickbooks_invoice、update_quickbooks_customer、 update_quickbooks_vendor）は、オプトインなしで書き込みを実行します。 機能はデフォルトで有効になっており、ホストのツール承認レイヤーが ゲートとして機能します。読み取り専用ツール（list_*、get_*、query_*、download_*、 configure_quickbooks）には影響しません。

バージョン 0.3.0～0.4.0 では、これらの書き込みは 環境変数 QB_ALLOW_PROD_WRITES=1 によって制御されていました。 このゲートは削除されました。変数は読み取られなくなったため、ホストの設定から削除できます。

要件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストから次の値を入力するよう求められます：QUICKBOOKS_CLIENT_ID、QUICKBOOKS_CLIENT_SECRET、QUICKBOOKS_REFRESH_TOKEN、QUICKBOOKS_REALM_ID、QUICKBOOKS_ENVIRONMENT。

{
  "mcpServers": {
    "QuickBooks Online": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-quickbooks"
      ],
      "env": {
        "QUICKBOOKS_CLIENT_ID": "",
        "QUICKBOOKS_CLIENT_SECRET": "",
        "QUICKBOOKS_REFRESH_TOKEN": "",
        "QUICKBOOKS_REALM_ID": "",
        "QUICKBOOKS_ENVIRONMENT": "production"
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/quickbooks
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-quickbooks

ローカル

node dist/index.js

設定

環境変数

• QUICKBOOKS_CLIENT_ID — Intuit Developer アプリのクライアント ID
• QUICKBOOKS_CLIENT_SECRET — Intuit Developer アプリのクライアントシークレット
• QUICKBOOKS_REFRESH_TOKEN — OAuth 2.0 リフレッシュトークン
• QUICKBOOKS_REALM_ID — QuickBooks の会社（realm）ID
• QUICKBOOKS_ENVIRONMENT — sandbox または production（デフォルト：production）
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジ状態ファイルの任意のパス
• MINDSTONE_REBEL_BRIDGE_STATE — 後方互換性のための MCP_HOST_BRIDGE_STATE の別名

ホスト設定の例

Claude Desktop / Cursor

{
  "mcpServers": {
    "QuickBooks": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-quickbooks"],
      "env": {
        "QUICKBOOKS_CLIENT_ID": "your-client-id",
        "QUICKBOOKS_CLIENT_SECRET": "your-client-secret",
        "QUICKBOOKS_REFRESH_TOKEN": "your-refresh-token",
        "QUICKBOOKS_REALM_ID": "your-realm-id"
      }
    }
  }
}

ローカル開発（npm への公開は不要）

{
  "mcpServers": {
    "QuickBooks": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/quickbooks/dist/index.js"],
      "env": {
        "QUICKBOOKS_CLIENT_ID": "your-client-id",
        "QUICKBOOKS_CLIENT_SECRET": "your-client-secret",
        "QUICKBOOKS_REFRESH_TOKEN": "your-refresh-token",
        "QUICKBOOKS_REALM_ID": "your-realm-id"
      }
    }
  }
}

ツール（21）

設定

• configure_quickbooks — QuickBooks Online の OAuth 認証情報を設定します

クエリ

• query_quickbooks — QuickBooks Query Language を使用して QuickBooks にクエリを実行します
• get_quickbooks_entity — 種類と ID を指定して単一のエンティティを取得します

レポート

• get_quickbooks_report — 財務レポートを実行します（ProfitAndLoss、BalanceSheet、CashFlow、AgedReceivables、AgedPayables）

顧客

• list_quickbooks_customers — 顧客の一覧を取得します
• create_quickbooks_customer — 新しい顧客を作成します
• update_quickbooks_customer — 顧客を部分更新します（active: false で無効化）

仕入先

• list_quickbooks_vendors — 仕入先の一覧を取得します
• create_quickbooks_vendor — 新しい仕入先を作成します
• update_quickbooks_vendor — 仕入先を部分更新します（active: false で無効化）

請求書

• list_quickbooks_invoices — 請求書の一覧を取得します
• create_quickbooks_invoice — 新しい請求書を作成します
• update_quickbooks_invoice — 請求書のヘッダーフィールド（dueDate、memo、privateNote）を部分更新します
• send_quickbooks_invoice_email — 請求書を顧客にメールで送信します
• download_quickbooks_invoice_pdf — 請求書を PDF としてダウンロードします（システムの一時ディレクトリに保存）

見積書

• list_quickbooks_estimates — 見積書（見積）の一覧を取得します
• create_quickbooks_estimate — 新しい見積書を作成します

買掛金

• list_quickbooks_bills — 買掛金の請求書の一覧を取得します
• create_quickbooks_bill — 新しい買掛金の請求書を作成します

従業員

• list_quickbooks_employees — 従業員の一覧を取得します

勘定科目

• list_quickbooks_accounts — 勘定科目一覧を取得します

信頼できないコンテンツのエンベロープ

QuickBooks 内で作成されたテキスト（顧客／仕入先の表示名、メモ、明細の 説明、レポートのセル）は攻撃者の影響を受ける可能性があるため、コネクターは モデルに返す前に、これらを <untrusted-content source="quickbooks:…"> の エンベロープで囲みます。型付きエンティティのペイロードは、デフォルトで すべてを拒否する方式でサニタイズされます。すべての文字列はエンベロープで 囲まれます。これにはキーのコンテキストを持たない配列内の文字列も含まれます。 ただし、キーが限定された構造述語（ID、SyncToken、日付／タイムスタンプ、 列挙値）であり、値が形状ガードを通過する場合は除きます。query_quickbooks、 get_quickbooks_entity、およびレポートでは、すべての文字列のキーと値を 一括してエンベロープで囲みます。Id、SyncToken、日付、金額などの 構造化された値はそのまま保持されるため、後続の呼び出しの入力として 引き続き使用できます。

ライセンス

FSL-1.1-MIT — Functional Source License、Version 1.1。将来的に MIT ライセンスに移行します。このソフトウェアは 2030-04-08 に MIT ライセンスに移行します。