mcp-quickbooks

@codespar/mcp-quickbooks

QuickBooks Online（Intuit）用の MCP サーバーです。米国と英国で最も広く利用されている会計プラットフォームであり、小規模企業向け ERP の世界標準です。

これは、私たちのグローバル会計の要です。カタログではブラジルやラテンアメリカの ERP（Omie、Conta Azul、Alegra、Bling、Tiny）を扱っていますが、海外の顧客に請求するラテンアメリカの SaaS 企業や、米国企業の子会社は、ほぼ例外なく QuickBooks に帳簿を付けています。

ツール（22）

ツール	用途
create_customer	QuickBooks Online に顧客を作成します。
update_customer	顧客を更新します。
get_customer	QuickBooks のエンティティ ID で顧客を取得します。
list_customers	QBO の SQL 風クエリ言語を使って顧客を検索します。
create_invoice	請求書を作成します。
update_invoice	請求書を更新します。
void_invoice	請求書を無効にします。
delete_invoice	請求書を削除します。
get_invoice	QuickBooks のエンティティ ID で請求書を取得します。
send_invoice	請求書を顧客にメールで送信します。
create_payment	1 件以上の請求書に対する顧客の支払いを記録します。
get_payment	QuickBooks のエンティティ ID で支払いを取得します。
create_item	商品またはサービスの項目を作成します。
list_items	QBO の SQL 風クエリ言語を使って項目を検索します。
create_bill	仕入先への請求書（買掛金／仕入先への未払金）を作成します。
list_bills	QBO の SQL 風クエリ言語を使って請求書を検索します。
create_vendor	仕入先（サプライヤー）を作成します。
list_vendors	QBO の SQL 風クエリ言語を使って仕入先を検索します。
create_estimate	見積書（見積もり）を作成します。
create_sales_receipt	販売レシート（その場で支払いが完了する販売。請求書と支払いをまとめたもの）を作成します。
list_accounts	QBO の SQL 風クエリ言語を使って勘定科目表を検索します。
get_profit_and_loss_report	指定した期間の損益レポートを実行します。

インストール

npm install @codespar/mcp-quickbooks

環境

QB_ACCESS_TOKEN="..."   # OAuth2 bearer (expires in 1hr — caller refreshes)
QB_REALM_ID="..."       # company id, issued on authorization
QB_ENV="sandbox"        # or "production". Default: sandbox
QB_MINOR_VERSION="70"   # optional, default 70

認証

QuickBooks は OAuth2 の authorization_code フローを使用します。アクセストークンの有効期間は 1 時間、リフレッシュトークンの有効期間は 100 日です。このサーバーでは、有効な QB_ACCESS_TOKEN がすでに発行されていることを前提としています。トークンの取得と更新は MCP のひな形の範囲外で行います（通常はエージェントの認証情報マネージャーで管理します）。

実行

# stdio (default)
npx @codespar/mcp-quickbooks

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-quickbooks

クエリ言語

QuickBooks のリストエンドポイントでは、?query= 経由で渡される SQL 風の構文を使用します。例：

SELECT * FROM Customer WHERE Active = true MAXRESULTS 50
SELECT * FROM Item WHERE Type = 'Service'
SELECT * FROM Account WHERE AccountType = 'Income'

クエリ文字列全体を list_customers、list_items、list_accounts に渡してください。

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT