accountingqb

AccountingQB-MCP

Claude 向けの、最も包括的な QuickBooks Online MCP サーバーです。帳簿の管理、レポートの作成、税務申告の準備を自然な会話を通じて行いたい個人事業主や小規模事業者向けに構築されています。

取引、レポート、税務申告の準備（米国およびカナダ）、照合、スマート帳簿管理、1099/T4A レポート、GST/HST 申告、異常検知、クレジットメモ、仕入先クレジット、キャッシュフロー予測、利益率分析をカバーする138 個のツールを、すべて Claude Desktop から利用できます。CPA ワークブックも含まれます。年末用の 15 ページのファイル（比較財務諸表、照合の突合、納付済み税金、事業主の引き出し、税務整理票）を Excel にエクスポートして、会計士に渡せます。

**カナダのサポート：**カナダの QuickBooks Online 企業でそのまま利用できます。サーバーが企業の税務エディションを自動検出し、作成した取引に売上税コード（GST/HST/PST）を適用します。また、50％の食事費用に対する ITC 制限を反映した GST/HST（GST34）申告ワークペーパー、T2125 の項目マッピング、CCA スケジュール（半年度ルール＋加速投資優遇措置）、T4A/T5018 の請負業者レポート、CRA 分割納税額および CPP の見積もりを含む、カナダ向け税務機能一式を備えています。複数通貨を使用する企業では、取引ごとの通貨と為替レートが表示されます。

Vaspera Capital が開発しました。QuickBooks には本格的な MCP サーバーが必要だったからです。

---

クイックスタート

前提条件

• Python 3.10+
• QuickBooks Online アカウント（プラン不問）
• Claude Desktop
• Intuit Developer アカウント（無料登録）

1. クローンしてインストール

git clone https://github.com/RCOLKITT/AccountingQB-MCP.git
cd AccountingQB-MCP
pip install -r requirements.txt

2. Intuit Developer アプリを作成

1. developer.intuit.com にアクセスしてサインインします
2. アプリを作成をクリックし、QuickBooks Online and Paymentsを選択します
3. リダイレクト URIに、http://localhost:8080/callbackを追加します
4. クライアント IDとクライアントシークレットをコピーします

3. セットアップを実行

python setup.py

セットアップウィザードでは、次の操作を行います。

• クライアント ID とクライアントシークレットを入力します
• ブラウザーを開き、QuickBooks の企業へのアクセスを認可します
• OAuth コールバックを自動的に受け取ります
• Claude Desktop の設定を書き込みます
• 接続が機能することを確認します

これで完了です。Claude Desktop を再起動すると、接続されます。

手動設定（上級者向け）

手動で設定する場合は、次の設定を Claude Desktop の設定ファイルに追加してください。

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "accountingqb": {
      "command": "python3",
      "args": ["/path/to/AccountingQB-MCP/server.py"],
      "env": {
        "QB_CLIENT_ID": "your_client_id",
        "QB_CLIENT_SECRET": "your_client_secret",
        "QB_REALM_ID": "your_company_id",
        "QB_REFRESH_TOKEN": "your_refresh_token",
        "QB_ENVIRONMENT": "production"
      }
    }
  }
}

更新トークンを手動で取得するには、Intuit OAuth Playgroundを使用してください。

---

ツール（130）

企業とエンティティ

ツール	説明
qb_company_info	会社名、EIN、住所、会計年度
qb_list_accounts	残高を含む勘定科目一覧
qb_list_classes	クラス（クラス追跡セグメント）の一覧
qb_list_departments	部門／拠点（拠点追跡）の一覧
qb_list_vendors	仕入先／サプライヤーを検索
qb_list_customers	顧客を検索
qb_list_items	製品とサービス
qb_create_vendor	新しい仕入先を作成
qb_create_customer	新しい顧客を作成
qb_update_vendor	仕入先の詳細（メールアドレス、電話番号、住所）を更新
qb_update_customer	顧客の詳細（メールアドレス、電話番号、住所）を更新
qb_create_account	勘定科目一覧に勘定科目を追加
qb_create_sub_account	親勘定科目の下に補助勘定科目を作成
qb_inactivate_account	使用していない勘定科目を非表示にする

取引

ツール	説明
qb_list_transactions	フィルターを指定して購入／経費を取得
qb_list_deposits	収入と所有者による投資
qb_list_transfers	口座間の振替
qb_list_journal_entries	調整と再分類
qb_list_journal_entries_by_memo	メモのテキストで仕訳を検索
qb_list_bills	買掛金
qb_list_bill_payments	請求書の支払い
qb_list_sales_receipts	直接販売
qb_list_payments	受領した顧客からの支払い
qb_list_invoices	ステータスフィルターを指定して請求書を取得
qb_list_credit_memos	顧客向けの貸方票／返金
qb_list_vendor_credits	受領した仕入先クレジット
qb_list_estimates	ステータスフィルターを指定して見積もり／見積書を取得
qb_search_transactions	すべての取引タイプを横断して検索
qb_list_purchase_orders	発注書の一覧 — 仕入先、金額、Open／Closed ステータス
qb_list_recurring_transactions	定期取引のテンプレートとスケジュール
qb_transaction_detail	任意の単一取引の詳細
qb_account_transactions	特定の勘定科目に計上されたすべての取引

作成と変更

ツール	説明
qb_create_expense	購入／経費を記録
qb_create_invoice	顧客向け請求書を作成
qb_create_bill	仕入先請求書を作成
qb_create_estimate	顧客向け見積もり／見積書を作成
qb_create_journal_entry	調整を記録
qb_create_deposit	銀行預金を記録
qb_create_transfer	口座間の振替
qb_create_credit_memo	顧客向け貸方票を発行
qb_create_vendor_credit	仕入先クレジットを記録
qb_convert_estimate_to_invoice	見積もりを請求書に変換
qb_record_bill_payment	仕入先請求書への支払いを記録
qb_record_invoice_payment	請求書に対する顧客からの支払いを記録
qb_update_transaction	任意の取引を更新
qb_void_transaction	取引を無効化
qb_delete_transaction	取引を完全に削除
qb_delete_journal_entry	仕訳を完全に削除
qb_reclassify_transaction	取引を別の勘定科目に移動
qb_bulk_update_vendor	複数の取引に仕入先を一括割り当て
qb_bulk_update_vendors_multi	1 回の呼び出しで複数の仕入先を一括割り当て
qb_batch_create_expenses	経費の一括インポート
qb_batch_create_bills	請求書の一括インポート
qb_batch_create_journal_entries	仕訳の一括インポート

レポートと分析

ツール	説明
qb_profit_loss	合計、月、四半期、年別の損益
qb_profit_loss_detail	損益の詳細 — 勘定科目ごとに各項目の基となるすべての取引を表示
qb_profit_loss_by_class	クラス（セグメント／プログラム）別の損益
qb_profit_loss_by_department	部門／所在地別の損益
qb_vendor_expenses	仕入先別の支出合計（VendorExpenses レポート）
qb_balance_sheet	任意の日付時点の貸借対照表
qb_sales_by_customer	顧客別の売上（収入）合計
qb_sales_by_product	商品／サービス別の売上 — 数量と金額
qb_sales_by_class	クラス（セグメント／プログラム）別の売上
qb_sales_by_department	部門／所在地別の売上
qb_inventory_valuation	日付時点の在庫数量、資産価値、平均原価
qb_transaction_list	期間を指定できる柔軟な取引一覧
qb_customer_balance_detail	顧客別の未決済請求書と明細（売掛金の詳細）
qb_vendor_balance_detail	仕入先別の未決済請求書と明細（買掛金の詳細）
qb_cash_flow	キャッシュフロー計算書
qb_cash_flow_forecast	複数期間のキャッシュフロー予測
qb_general_ledger	勘定科目別の全取引
qb_trial_balance	帳簿の貸借が一致しているか確認
qb_ar_aging	顧客からの未回収額
qb_ap_aging	仕入先への未払い額
qb_expense_summary	カテゴリ別の経費
qb_income_summary	収入源別の収入
qb_sales_tax_summary	管轄区域別の徴収済み売上税
qb_sales_tax_nexus	エコノミック・ネクサスの確認 — 州ごとの出荷先別売上と各州の売上基準額（Wayfair）との比較、および州別の納税義務
qb_compare_periods	期間を並べて比較
qb_vendor_summary	支出額上位の仕入先
qb_profit_margin_analysis	顧客別または品目別の利益率
qb_budget_vs_actual	予算と実際の支出を比較
qb_anomaly_detection	統計的な異常および不正の検出

税務申告の準備

ツール	説明
qb_tax_summary	スケジュールCの項目に対応付けた経費
qb_schedule_c	IRS スケジュールCの全項目を行ごとに表示
qb_schedule_c_detailed	QuickBooks の勘定科目の詳細を含む、粒度の細かいスケジュールC
qb_estimate_quarterly_tax	連邦税および州税の予定納税額
qb_deduction_finder	見落としがちな控除を検索
qb_depreciation_schedule	Section 179 および MACRS の償却スケジュール
qb_1099_contractor_report	TIN／住所の検証を含む、1099-NEC の請負業者報告
qb_home_office_calculator	Form 8829 のホームオフィス控除計算ツール
qb_vehicle_depreciation_calculator	事業使用率（%）を考慮した車両の減価償却
qb_payroll_checklist	給与計算の境界チェックリスト — 賃金／負債の兆候と、会計士に引き継ぐ W-2／1099、941／940 の項目

カナダの税務（GST/HST、T2125）

ツール	説明
qb_gst_hst_return	GST34 申告書のワークシート — 50%の食事費用に対する ITC 制限、TaxSummary レポート、納税、および Quick Method の注記を含む、101／103／105／106／108／109 の各項目
qb_t2125_summary	CRA T2125 の項目ごとの対応付け（8521 広告費、8523 食事費用は50%、8910 賃借料など）
qb_cca_schedule	クラス別の資本コスト控除 — 半年ルール、加速投資インセンティブ、クラス10.1／54の上限
qb_t4a_contractor_report	BN／住所の検証を含む、T4A のボックス048に関する請負業者報告（建設業向け T5018 の注記）
qb_estimate_instalments	CRA の予定納税（3月／6月／9月／12月15日）と正確な CPP／CPP2、および連邦税／州税の概算
qb_list_tax_codes	売上税コード（名前、合算税率、税務機関）— 作成ツールの tax_code= に指定
qb_list_tax_rates	個別の売上税率と税務機関

スマート機能

ツール	説明
qb_uncategorized_transactions	未分類の取引を検索します
qb_find_duplicates	重複の可能性がある取引を検出します
qb_auto_categorize_suggestions	取引先の履歴に基づいて、AI がカテゴリーを提案します
qb_monthly_burn_rate	月ごとの経費の推移を確認します
qb_runway_calculator	手元資金で何か月運営できるかを計算します
qb_fiscal_year_close_checklist	年末締めの準備状況を確認します
qb_books_health_audit	帳簿の包括的な健全性監査を実行します
qb_books_hygiene	構造的な監査：削除済みアカウントへの記帳、残高の符号間違い、カード支払いの誤分類、休眠残高、明細書の証明
qb_month_end_close	状況確認付きの月末締めチェックリスト
qb_unknown_vendor_report	取引先名が欠落している取引を検索します

照合と添付ファイル

ツール	説明
qb_reconcile_invoices	請求書を QB の取引と照合します
qb_match_invoices_to_transactions	許容差を設定して、あいまい一致で照合します
qb_upload_receipt	領収書を取引に添付します
qb_list_attachments	添付書類を一覧表示します
qb_missing_receipts	領収書が添付されていないしきい値以上（デフォルトは $75）の経費を検索します — IRS の証憑要件を満たしていない状態です
qb_change_audit_trail	指定日以降の変更内容を確認します — 作成、更新、削除された取引（QuickBooks CDC）
qb_bank_reconciliation	銀行／クレジットカードの明細 CSV を帳簿と照合します — 一致、不足、未決済を確認します
qb_stripe_reconcile	Stripe の取引を照合します — クリアリングアカウントを通じて処理手数料およびプラットフォーム手数料（Sigma／Billing／Radar）を差し引き、Stripe の残高と一致させます
qb_account_balance	任意のアカウント残高を確認します

接続と複数会社の管理

ツール	説明
qb_list_companies	接続済みの QuickBooks 会社をすべて一覧表示します
qb_switch_company	別の会社に切り替えます
qb_refresh_connection	AccountingQB への接続を更新します

---

使用例

接続したら、Claude に自然な言葉で尋ねるだけです。

• 「2025 年の損益計算書を見せて」
• 「先月の $500 を超える経費をすべて表示して」
• 「ソフトウェアのサブスクリプション費として GitHub 宛てに $49.99 の経費を作成して」
• 「2025 課税年度の Schedule C を作成して」
• 「未分類の取引がないか検索して」
• 「月ごとの資金消費率はどれくらい？」
• 「あと何か月運営できる資金がある？」
• 「第 1 四半期と第 2 四半期の損益を比較して」
• 「重複の可能性がある取引を検索して」
• 「控除の申告漏れがないか確認して」
• 「1099 契約業者レポートを作成して」
• 「前四半期の取引で異常検出を実行して」
• 「顧客別の利益率を表示して」
• 「今後 6 か月のキャッシュフローを予測して」
• 「Amazon 宛てに $200 の仕入先クレジットを作成して」
• 「見積書 #1042 を請求書に変換して」
• 「第 2 四半期の GST／HST 申告ワークペーパーを作成して」（カナダ）
• 「帳簿を T2125 に対応付けて、CRA の分割納付額を見積もって」（カナダ）

---

セキュリティ

このサーバーはセキュリティを重視しています。

• コードに認証情報を含めません — すべてのシークレットは環境変数から取得します
• 自動トークンローテーションを備えた OAuth 2.0
• ローカル限定の OAuth フロー — セットアップスクリプトは 127.0.0.1 でコールバックサーバーを実行します
• .env ファイルは gitignore の対象で、chmod 600（所有者のみアクセス可能）に設定されています
• データを保存しません — サーバーはステートレスで、QuickBooks との読み書きのみを行います
• リフレッシュトークンはローテーションします — トークン交換のたびに新しいリフレッシュトークンが返されます
• 有効期限は 100 日 — 100 日間操作がないとトークンの有効期限が切れます（Intuit のポリシー）

トークン管理

QuickBooks のリフレッシュトークンは 100 日間有効で、使用するたびに自動的にローテーションされるため、アクティブな接続は無期限に維持されます。接続が失効した場合（100 日以上使用していない場合）は、AccountingQB の利用方法に応じて再接続してください。

• ホステッド／マネージド（ライセンスキーをお持ちの場合）： Claude でまず qb_refresh_connection を実行してください。ブラウザー操作なしで、期限切れの接続のほとんどが自動的に再確立されます。接続が完全に切れている場合は、accountingqb.com/dashboard → QuickBooks に接続から再接続し、その後 qb_refresh_connection をもう一度実行してください。
• セルフホスト（独自の Intuit アプリを使用する場合）： python setup.py を再実行して再認証し、リフレッシュトークンを書き換えてください。

---

サンドボックスモード

本番環境に接続する前に、Intuit のサンドボックスでテストしてください。

python setup.py --sandbox

Intuit のテストデータを使用して sandbox-quickbooks.api.intuit.com に接続します。本番環境を使用する準備ができたら、フラグを指定せずにセットアップを再実行してください。

---

トラブルシューティング

「QuickBooks の認証情報が設定されていません」 セルフホストの場合：python setup.py を実行して認証情報を設定するか、Claude Desktop の設定を確認してください。ホステッド／マネージドの場合：QB_LICENSE_KEY を設定し、accountingqb.com/dashboard で会社に接続してください。

「401 Unauthorized」 接続の有効期限が切れている可能性があります（100 日間のアイドル制限）。ホステッド／マネージドの場合：まず qb_refresh_connection を実行し、必要に応じて accountingqb.com/dashboard → QuickBooks に接続から再接続してください。セルフホストの場合：python setup.py を再実行して再認証してください。

「会社が見つかりません」 QB_REALM_ID が認証した会社と一致していることを確認してください。QuickBooks Online にログインしたときの URL で確認できます。

Claude Desktop にツールが表示されない セットアップの実行後、Claude Desktop を再起動してください。Claude Desktop の設定に accountingqb エントリがあることを確認してください。

サンドボックスと本番環境 テストデータが表示される場合は、設定で QB_ENVIRONMENT が "production" に設定されていることを確認してください。

---

コントリビューション

Issue と PR を歓迎します。新しいツールを追加する場合は、既存のパターンに従ってください。

• Claude Desktop との互換性を保つため、Pydantic モデルではなくフラットなパラメーターを使用する
• 説明的な docstring を記述する
• 実行可能なメッセージを表示して、エラーを適切に処理する
• README の表にツールを追加する

---

ライセンス

プロプライエタリ — © Vaspera Capital LLC、無断転載を禁じます。 ソースは透明性とセキュリティレビューのために 公開されていますが、オープンソースではありません。利用には有料のライセンスキーが必要です。LICENSE をご覧ください。

Vaspera Capital が開発