mcpField
Q
QuickBooks Desktop

QuickBooks Desktop

ローカル
github.com金融データ15 日前に更新

QuickBooks Desktop について

QuickBooks Desktop は、Windows 版 QuickBooks Desktop を LLM やエージェントに接続するオープンソースの MCP サーバーです。会計データをローカルで読み取り、明示的に有効化するまで変更操作を無効にします。

主な機能

  1. 01レコードと標準レポートの読み取り
  2. 02有効化後の作成、更新、削除、無効化
  3. 03変更内容のプレビューと確認
  4. 04機密性の高い財務識別情報のマスキング
  5. 05QuickBooks SDK 経由のローカル実行

活用シーン

  1. 01請求書、買掛金、支払いの確認
  2. 02財務レポートの確認
  3. 03在庫と顧客レコードの確認
  4. 04監査ログを残した承認済み変更

MCP 対応

同じ Windows PC 上の QuickBooks Desktop に MCP クライアントを接続します。アクセスキー付きの localhost HTTP で MCP を提供することもできます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

インストール方法は未掲載です

このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。

リポジトリ
パッケージ
npm@devwithmj/quickbooks-mcp0.1.6
nugetDevWithMJ.QuickBooks.Mcp0.1.6
mcpbquickbooks-mcp-win-x64.mcpb
mcpbquickbooks-mcp-win-x86.mcpb

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

quickbooks-mcp

QuickBooks Desktop(Pro、Premier、Enterprise)を LLM やエージェントに接続する、オープンソースの MCP サーバーです。

npm NuGet Release License: MIT

状況:バージョン 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を実行します
npxnpx -y @devwithmj/quickbooks-mcp
dnxdnx 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 OnlineQuickBooks Desktop Pro、Premier、Enterprise(Windows)
実行場所Intuit のクラウド API と通信PC 上で QuickBooks の隣で、ローカル SDK を通じて実行
セットアップとサインインIntuit デベロッパーアプリと OAuthQuickBooks 内で一度だけ「このアプリを許可」を承認(--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 をご覧ください。

ドキュメント

法的事項

Intuit とは提携しておらず、同社からの推奨も受けていません。NOTICE.md をご覧ください。

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。