QuickBooks Desktop について
QuickBooks Desktop は、Windows 版 QuickBooks Desktop を LLM やエージェントに接続するオープンソースの MCP サーバーです。会計データをローカルで読み取り、明示的に有効化するまで変更操作を無効にします。
主な機能
- 01レコードと標準レポートの読み取り
- 02有効化後の作成、更新、削除、無効化
- 03変更内容のプレビューと確認
- 04機密性の高い財務識別情報のマスキング
- 05QuickBooks SDK 経由のローカル実行
活用シーン
- 01請求書、買掛金、支払いの確認
- 02財務レポートの確認
- 03在庫と顧客レコードの確認
- 04監査ログを残した承認済み変更
MCP 対応
同じ Windows PC 上の QuickBooks Desktop に MCP クライアントを接続します。アクセスキー付きの localhost HTTP で MCP を提供することもできます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
quickbooks-mcp
QuickBooks Desktop(Pro、Premier、Enterprise)を LLM やエージェントに接続する、オープンソースの MCP サーバーです。
状況:バージョン 1.0 以前です。これまで QuickBooks Desktop Enterprise Accountant 24.0 と Intuit のサンプル会社ファイルで動作を確認しています。他のエディションと年度のバージョンはまだテストされていません(COMPATIBILITY.mdと、協力できる方はテスターガイドをご覧ください)。
利用できる機能
- 読み取り: 顧客、仕入先、従業員、品目、勘定科目、請求書、買掛金、支払い、在庫、時間、カスタムフィールド、および標準レポート(売掛金・買掛金の滞留表、損益計算書、貸借対照表など)をコンパクトなテーブル形式で取得します。
- 変更(許可した場合のみ): プレビュー、確認トークン、冪等性キー、バッチ処理、監査ログを備え、作成、更新、削除、無効化ができます。
- デフォルトで安全: 読み取り専用で、納税者番号、銀行口座番号、カード番号はマスクされ、給与計算は無効です。カードデータは受け付けません。
- ローカル: QuickBooks の隣で Windows PC 上で動作し、SDK 経由で通信します。クラウドもテレメトリもありません。
インストール
| Claude Desktop | 最新リリースの.mcpbを開きます |
| Claude Code | /plugin marketplace add devwithmj/quickbooks-mcpを実行し、続けて/plugin install quickbooks-desktop@quickbooks-mcpを実行します |
| npx | npx -y @devwithmj/quickbooks-mcp |
| dnx | dnx DevWithMJ.QuickBooks.Mcp --yes |
| exe | リリースのquickbooks-mcp-win-x64.exe(または-win-x86) |
次に、QuickBooks で一度アクセスを許可し(--authorize)、MCP サーバーを AI アプリに追加します。手順はこちらをご覧ください:docs/GUIDE.md。
パッケージと掲載先:npm、NuGet、GitHub リリース、公式 MCP Registry(io.github.devwithmj/quickbooks-mcp)、Glama。
変更を有効にする
オプトインするまでは、すべて読み取り専用です。MCP クライアントが MCP サーバーを起動する際に渡す引数に、次のフラグを追加してください:
"args": ["-y", "@devwithmj/quickbooks-mcp", "--allow-writes"]
または環境変数を設定します。すべての変更を許可するにはQB_ALLOW_WRITES=trueを、変更の種類ごとに許可するにはQB_ENABLE_WRITE、QB_ENABLE_UPDATE、QB_ENABLE_DELETEを設定します(QB_WRITE_ALLOW=Invoice,Customerを指定すると、変更可能なレコードの種類を限定できます)。削除と無効化には、必ず確認ステップが必要です。詳細:docs/WRITES.md。
HTTP 経由で使用する(上級者向け)
ほとんどのクライアントは MCP サーバーを自動で起動します。自動起動できないクライアントの場合、quickbooks-mcp --httpを実行すると、127.0.0.1:8765のみで MCP を HTTP 経由で提供します。すべてのリクエストにアクセスキーが必要です(起動時に表示されます。QB_HTTP_KEYで設定することもできます)。--http-allow-writesも渡さない限り、変更は無効のままです。別のデバイスから接続するには、独自のトンネルを前段に設置してください:docs/REMOTE-ACCESS.md。
QuickBooks Online または Desktop のどちらですか?
このプロジェクトは QuickBooks Desktop 用です。QuickBooks Online をお使いの場合は、Intuit 独自のサーバーをお使いください:intuit/quickbooks-online-mcp-server(Apache-2.0)。設計を参考にしましたが、独自にコードを作成しており、コードのコピーはありません。
| QuickBooks Online サーバー(Intuit) | このプロジェクト(Desktop) | |
|---|---|---|
| 対象 | QuickBooks Online | QuickBooks Desktop Pro、Premier、Enterprise(Windows) |
| 実行場所 | Intuit のクラウド API と通信 | PC 上で QuickBooks の隣で、ローカル SDK を通じて実行 |
| セットアップとサインイン | Intuit デベロッパーアプリと OAuth | QuickBooks 内で一度だけ「このアプリを許可」を承認(--authorize);デベロッパーアカウントは不要 |
| Desktop のみ | 在庫アセンブリとサイト、価格レベル、労災コード、データ拡張によるカスタムフィールド、QuickBooks ウィンドウでのレコード表示 | |
| Online のみ | 添付ファイル、請求書 PDF、その他のクラウド機能 | |
| 安全性の既定値 | 該当プロジェクトを参照 | 書き込みを有効にするまでは読み取り専用;削除と無効化には承認が必要;機密番号はマスク;給与機能は無効;監査ログ |
| データの経路 | Intuit のクラウド経由 | アシスタントに表示される情報を除き、コンピューター内に保持 |
この 2 つで会社ファイルやアカウントを共有することはありません。Online を利用する事業者はこのプロジェクトを使用せず、Desktop を利用する事業者は Intuit のサーバーを使用できません。
要件
- QuickBooks Desktop がインストールされ、ライセンス認証済みの Windows。
- 一度限りの認証を行うための、会社ファイルへの管理者アクセス権。
QuickBooks Online(Intuit 独自の MCP サーバーがあります)、QuickBooks for Mac(SDK がありません)、カード決済処理、Windows サービスとしての実行には対応していません。docs/SCOPE.md をご覧ください。
ドキュメント
- ユーザーガイド:インストール、認証、クライアントの接続、トラブルシューティング、FAQ
- ツール:すべてのツール、パラメーター、使用例
- プロンプトのレシピ集、書き込み、レポート
- 対象範囲と対象外、セキュリティモデル
- ロードマップ、1.0 チェックリスト
- サポート、アップグレード、アンインストール、互換性、パフォーマンス
- ソースからのビルド、リリース、テスト、コントリビューション
法的事項
Intuit とは提携しておらず、同社からの推奨も受けていません。NOTICE.md をご覧ください。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。