QuickBooks Online MCP

QuickBooks Online + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP を話すあらゆるエージェント向け

非公式です。QuickBooks Online API 用の、コミュニティが構築した Claude Code スキルおよび MCP サーバーです。Intuit Inc. とは提携しておらず、同社による承認や後援も受けていません。

_{▶ 30 秒のデモを見る - デモデータはシミュレーションです。表示されるコマンドはすべて、実際の CLI に存在します。}

すべての QuickBooks Online Accounting エンティティに加え、オフラインの SQLite ミラー、エンティティ横断検索、AR/AP 経過日数分析を備えています。SDK は不要で、読み取り専用の MCP は付属しません。すでにお使いの AI で動作します - ChatGPT（Plus/Pro+。このコネクターが再発行されるまで一時停止中。詳細は mcp-install.md を参照）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot に加え、リモート経由で Microsoft 365 Copilot / Copilot Studio および Google Gemini に対応しています。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに構築されています。コーディングは不要です。

エージェントで利用できます

セキュリティに関する注意（このコネクターが再発行されるまで）。 HTTP モード （--transport http）は、localhost 上であっても実行しないでください。このビルドにはパスワードがなく、 すべてのネットワークインターフェースで待ち受けます。また、ブラウザーのリバインディング対策が追加される前のものなので、 開いたウェブページからアクセスできてしまいます。MCP ツールはお使いの認証情報を使って変更を加えることもできます。 デフォルトの stdio トランスポートを使用してください。リモートエージェント用にトンネルを設定した場合は、 シャットダウンしてください。修正を準備中です。

MSP オーナーが実際に使っている 6 つのエージェント（セルフサービスで、すぐに利用できます）：

お使いの AI エージェント	QuickBooks Online スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions から quickbooks-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再発行されるまで一時停止中です。ChatGPT では HTTP モードが必要ですが、このビルドの HTTP モードはパスワードを要求せず、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスできてしまいます。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に quickbooks-mcp を追加してから、Agent モードを選択します。

ChatGPT ではリモート HTTPS サーバーが必要です。つまり、このコネクターの HTTP モードが必要ですが、コネクターが再発行されるまで利用を停止しています。このビルドの HTTP モードはパスワードを要求せず、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスできてしまいます。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft と Google のスタックにも対応

多くのユーザーが利用していますが、正直にお伝えすると、これらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリを使う方法ではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再公開されるまで一時停止しています。Copilot Studio では HTTP モードが必要ですが、このビルドではそのモードはパスワードを必要とせず、すべてのネットワークインターフェースで待ち受け、開いた Web ページからアクセスできる状態になります。詳しくは mcp-install.md のセキュリティに関する注意事項をご覧ください。
Google Gemini	Gemini CLI は Claude Code と同じくローカルで動作します。Gemini アプリはリモートで動作するため、ChatGPT と同じ一時停止中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブのエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。インストール方法については、以下の各セクションをご覧ください。Cursor、Windsurf、Cline、Continue.dev、Zed でも MCP 経由で動作します。ツールごとの詳しい接続方法については、docs/which-agent.md をご覧ください。

複数のエージェントを実行しますか？ 1 つのコマンドで、サポート対象の 51 以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。その後、CLI／MCP バイナリ用のスキル別インストーラーを実行してください）。docs/which-agent.md をご覧ください。

60 秒でインストール

Claude Desktop で最速の方法 - ワンクリックの .mcpb

Claude Desktop バンドル： .mcpb は macOS（Intel および Apple Silicon）、Windows x64、Linux x64 で起動します。すべてのツールは、付属の quickbooks-cli をシェル経由で実行します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドル内に含まれています。それ以前のバンドルには MCP サーバーのみが含まれるため、付属の CLI がない場合は、先に以下の Path A または Path B のインストーラーを実行するか、既存のバイナリを QUICKBOOKS_CLI_PATH に設定してください。詳細： #331。

QuickBooks Online MCP（.mcpb）をダウンロード - ダウンロード後、Claude Desktop > Settings > Extensions を開き、ファイルを選択してください。ワンクリックで完了し、JSON もシェルも必要ありません。（リリースページですべての QuickBooks Online リリースを確認できます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールしてください。ディレクトリ一覧の取得は不要で、すぐに使えます：

/plugin marketplace add Servosity/msp-skills
/plugin install quickbooks@msp-skills

Path A - AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください：

このエージェントのワークスペースに、Servosity/msp-skills から QuickBooks Online Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、または Bash）を使用する場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.sh) を実行してください。Windows PowerShell を使用する場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.ps1 | iex を実行してください。その後、README に従って認証し、quickbooks-cli --help を実行して使い方を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使用できます。

Path B - インストーラーを自分で実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.sh)

インストーラーは、quickbooks-cli（CLI）と quickbooks-mcp（MCP サーバー）の両方をユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を通じてスキルを検出します。

確認：

quickbooks-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新のリリースを取得します。アップグレードするには、もう一度実行してください：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quickbooks/install.ps1 | iex

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの冒頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインのユーザー：/plugin update quickbooks@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、または別の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法については mcp-install.md と docs/which-agent.md をご覧ください。GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot／Copilot Studio の接続方法も、エージェントごとに記載されています。最も簡単なのは Claude Desktop の「設定」>「拡張機能」パネルを使う方法です。JSON の編集を希望するユーザー向けの MCP 設定ブロックは、mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から実行します。

hermes skills install servosity/msp-skills/skills/quickbooks --force

Hermes のチャットセッション内で実行します。

/skills install servosity/msp-skills/skills/quickbooks --force

Hermes は MCP にネイティブ対応しているため、quickbooks-mcp サーバーも直接使用できます。インストール方法も環境変数も同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えます（コピーしてください）。

https://github.com/servosity/msp-skills/tree/main/skills/quickbooks から quickbooks スキルをインストールしてください。このスキルでは、必要な CLI（quickbooks-cli）を openclaw: フロントマターブロック経由でインストールする方法を定義しています。

OpenClaw はまだ一般公開されていません。フロントマターの接続設定はあらかじめ含まれており、OpenClaw の公開と同時に有効になります。

認証する

CLI に必要な認証情報を設定します。必要なのは OAuth アクセストークン （スコープ com.intuit.quickbooks.accounting）と会社の realm ID の 2 つです。トークンはユーザーを示し、realm ID は読み取る会社を示します。

export QUICKBOOKS_ACCESS_TOKEN=<token>     # from the Intuit OAuth 2.0 Playground, or: quickbooks-cli auth refresh
export QUICKBOOKS_REALM_ID=<company-id>    # your QuickBooks Online company (realm) ID
# optional: export QUICKBOOKS_ENVIRONMENT=sandbox   # default is production
quickbooks-cli doctor

doctor は、データにアクセスする操作を実行する前に、認証情報と会社のスコープが有効かどうかを確認します。認証情報が拒否された場合でも終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。有効なアクセストークンではなくリフレッシュトークンをお持ちですか？ quickbooks-cli auth refresh を実行すると新しいトークンが発行されます（QUICKBOOKS_CLIENT_ID、QUICKBOOKS_CLIENT_SECRET、 および QUICKBOOKS_REFRESH_TOKEN を設定してください）。

このスキルでできること

会社のデータを一度同期すれば、次のように質問できます。

MSP からよく聞かれる質問	コマンド
誰が未払いで、0～30日／31～60日／61～90日／90日超の各期間でいくらありますか？	quickbooks-cli ar-aging --agent
仕入先への未払い額はいくらで、支払期限はいつですか？	quickbooks-cli ap-aging --agent
期限を過ぎた請求書のうち、どれから督促すべきですか？	quickbooks-cli invoices stale --days 30 --agent
口座、売掛金、買掛金を含めた現金残高はいくらですか？	quickbooks-cli balances --agent
今後 4 週間に予定されている現金の純増減額はいくらですか？	quickbooks-cli cash-forecast --weeks 4 --agent
DSO はいくらで、支払いが最も遅いのは誰ですか？	quickbooks-cli dso --agent
今月の月次締めに向けて、帳簿は十分に整っていますか？	quickbooks-cli reconcile --agent
前回の確認以降に、どの未払い項目が期間区分をまたいでいますか？	quickbooks-cli aging-delta --agent

コマンドの完全なリファレンスについては、guide.md をご覧ください。AI エージェントの運用ルール（--agent、--dry-run、データ変更前に確認すべき場合）については、AGENTS.md をご覧ください。

このスキルの特長

多くの QuickBooks Online 連携や MCP サーバーでは、質問のたびにライブ API 呼び出しへ中継します。1 件のレコードなら問題ありません。しかし、「帳簿全体で期限超過になっているのは誰で、90 日超の項目はいくらか」と尋ねる月次締めの時期には対応できません。QuickBooks には、期間別未払い額、DSO、または照合結果を返す単一のエンドポイントがないためです。

このスキルは QuickBooks Online を、全文検索機能を備えた ローカルの SQLite ミラーに同期します。集計の質問は 1 回のローカル SQL 結合で処理できるため、即座に、オフラインで回答でき、AI が生データではなく答えを受け取れます。ar-aging、dso、reconcile などの複合コマンドは、請求書、支払い、顧客、仕入先を実際の日付計算とともに結合します。これはステートレスな API ラッパーでは実現できません。

解決する課題

MSP のオーナーに月末最終日に何が重荷になるのか尋ねれば、帳簿だという答えが返ってきます。r/msp や r/QuickBooks では、未消込の入金を追いかけ、「Acme Inc」と「Acme, Inc.」の重複を整理し、会計士に渡す前に総勘定元帳の残高が合っていることを証明するため、締め処理が長引くという不満が繰り返し寄せられています。売掛金の延滞は気付かれないまま進みます。A/R Aging Summary をエクスポートした頃には、90日超の区分に回収に苦労する資金が積み上がっています。また、QuickBooks のレポートは特定時点の状態しか示さないため、自分でスプレッドシートに履歴を残しておかない限り、先月からどの顧客が別の区分に移ったかを確認できません。

このスキルを使えば、それぞれの作業をオフラインでの質問に置き換えられます。

作業	コマンド
エクスポートしてピボットテーブルを作らずに、支払期限を過ぎている顧客を確認する	quickbooks-cli ar-aging --agent
今週の回収連絡リストを作成する	quickbooks-cli invoices stale --days 30 --agent
月末の締め処理で必要な確認をまとめて実行する	quickbooks-cli reconcile --agent
重複した顧客／仕入先レコードを見つける	quickbooks-cli dupes customers --agent
前回の確認から売掛金の延滞状況がどう変わったかを確認する	quickbooks-cli aging-delta --agent

詳しい説明は pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）は、HTTPS 経由のリモート MCP サーバーにのみ接続できます。そのためには、QuickBooks Online MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードはパスワードを要求せず、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスできてしまいます。そのため、コネクターが再発行されるまでは実行したり、トンネルの背後に配置したりしないでください。その理由は mcp-install.md のセキュリティに関する注意事項で説明しています。それまでは、Claude Desktop、Claude Code、または Codex をお使いください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini でも使えますか？

はい。いずれも MCP に対応しています。他のツールへのインストールコマンドは上の一覧と、docs/which-agent.md の詳細ガイドをご覧ください。

コードの知識は必要ですか？

いいえ。推奨されるインストール方法は、Claude Code または Codex に一文を貼り付けるだけです。エージェントが SKILL.md を読み込んでインストールを実行します。代替手段として、OS ごとの1行インストーラー（bash または PowerShell）もあります。どちらの方法でも、コードを書く必要はありません。QuickBooks Online の認証情報を一度入力するだけです。

QuickBooks Online のデータは安全ですか？

データはお使いのマシンから外に出ません。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーはユーザーアカウント配下のディレクトリに保存されます。AI エージェントに見えるのは CLI が返す内容のみで、通常はクエリ結果であり、未加工の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。MSP Skills がこのリポジトリに含めたり、外部に送信したりすることはありません。

QuickBooks API のレート制限に達しますか？

その心配はほとんどありません。API を多く使うのは、会社のデータをローカルの SQLite にミラーする最初の sync だけです。その後の ar-aging、dso、cash-forecast、reconcile などの処理はすべて、ミラーに対して完全にオフラインで実行されます。Intuit は会社（realm）ごとにスロットリングを行いますが、CLI が同期時にページネーションとレート制限を適用するため、日々の質問で API にアクセスすることはありません。

利用するには Intuit のパートナーになる必要がありますか？

いいえ。必要なのは、QuickBooks Online の会社と、com.intuit.quickbooks.accounting のスコープを持つ OAuth アクセストークン、および会社の realm ID です。Intuit Developer ポータルまたは OAuth 2.0 Playground でトークンを取得してください。quickbooks-cli auth refresh を実行すると、リフレッシュトークンから新しいアクセストークンを取得できます。パートナー資格は必要ありません。

QuickBooks Online ポータルの代わりになりますか？

いいえ。ポータルと併用するものです。帳簿の正式な記録には引き続き QuickBooks を使います。このスキルを使うと、ターミナルや AI エージェントから質問に答えられ、ポータルにはない実行をまたいだ売掛金の延滞履歴を保持でき、UI では手作業で組み立てる必要がある月末の reconcile を一度の実行で作成できます。書き込みには、ポータルと同じ Accounting API を使用します。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。お支払いいただくのは、使用する AI エージェント（Claude、ChatGPT、Codex など）の料金のみで、請求は当社ではなく AI プロバイダーから行われます。

安全性モデル

Tier	例	推奨されるエージェントのポリシー
読み取り	ar-aging、ap-aging、balances、dso、cash-forecast、reconcile、dupes、search、およびすべての list / get	許可
書き込み（通常）	invoices / bills / payments / customers / vendors / accounts / items / journal-entries の create と update（16 コマンド）、および一括 import	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
破壊的操作／設定	invoices delete、bills delete、payments delete、journal-entries delete（完全削除）	必ず人間が確認

最も強力な制御は、QuickBooks Online の認証情報に付与するスコープです。CLI で実行できるのは、その認証情報で許可された操作に限られます。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

本番環境で稼働確認済みです。保守担当者の Servosity が、自社の本番テナントで確認しました。ほかの MSP も、毎週開催される Build Sessions で本番稼働させています。compoundingteams.com/build-sessions で参加登録してください。

---

標準規格。 オープンな Agent Skills 仕様（Anthropic、2025 年 12 月、40 以上のエージェント）に準拠しています。MCP 互換で、Hermes を含む MCP 対応エージェントで動作します。OpenClaw に対応しており（フロントマターの設定は済んでいて、OpenClaw の公開待ちです）。

Servosity が保守しています。Apache-2.0 ライセンスです。CLI Printing Press で構築されています。最終更新日：2026-06-06。