OpenBudget MCP Server

OpenBudget MCP Server

銀行口座、支出、負債、投資情報を AI アシスタントから利用できます。

OpenBudget はホスト型の Model Context Protocol（MCP）サーバーで、Claude、ChatGPT、Cursor、Codex、その他の MCP クライアントから金融データにアクセスできます。これには、Plaid を通じて米国の金融機関から同期された取引、残高、純資産、クレジットカード、ローン、住宅ローン、投資保有資産、投資活動が含まれます。また、現金、ギフトカードの残高、不動産、非公開企業の持分など、自分で管理するその他の資産も追加できます。

何も実行する必要はありません。サーバーは OpenBudget のインフラストラクチャでホストされています。クライアントに URL を追加し、一度サインインすれば、すぐに質問を始められます。

https://api.openbudget.sh/mcp

• トランスポート： Streamable HTTP（リモート MCP サーバー）
• 認証： OAuth 2.0。OpenBudget アカウントでサインインします
• プラン： Base は年額 $60、または月払い $9.95 です。Investor は年額 $99、または月払い $12.95 です。どちらも 7 日間の無料トライアルから始められます。
• データ： Plaid を通じて接続した、ご自身の銀行口座、証券口座、退職年金口座に加え、ご自身で追加した資産や活動

Plaid の接続で提供される金融データは読み取り専用です。OpenBudget が金融機関の認証情報を保存することはなく、AI アシスタントが送金や取引を行うこともできません。書き込み操作はすべて OpenBudget アカウント内にとどまります。対象は、カテゴリー、メモ、ルール、手動で追加する口座、カスタム保有資産、カスタム活動です。

---

クイック接続

以下からクライアントを選ぶか、手順をすべて記載したガイド openbudget.sh/connect-ai をご覧ください。

Claude (claude.ai / Claude Desktop)

1. Customize → Connectors → Add custom connector
2. 名前に openbudget.sh を入力し、https://api.openbudget.sh/mcp を貼り付けます
3. Connect をクリックし、銀行口座の連携に使ったアカウントでサインインします

詳しいガイド：openbudget.sh/connect-ai/claude

Claude Code

claude mcp add --transport http openbudget https://api.openbudget.sh/mcp

すべてのプロジェクトで利用するには、--scope user を追加します。その後、セッション内で /mcp を実行し、openbudget を選択して、Authenticate を選びます。

詳しいガイド：openbudget.sh/connect-ai/claude-code

ChatGPT (Plus / Team / Enterprise)

1. Settings → Apps → Advanced settings → Developer mode を有効にします
2. Create app を選び、名前に OpenBudget を入力して URL を貼り付け、OAuth を選択します
3. サインインしてアクセスを許可します

詳しいガイド：openbudget.sh/connect-ai/chatgpt

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に追加します。

{
  "mcpServers": {
    "openbudget": {
      "url": "https://api.openbudget.sh/mcp"
    }
  }
}

次に、Cursor Settings → Tools & MCP → Connect でサーバーを有効にします。

詳しいガイド：openbudget.sh/connect-ai/cursor

Codex / Codex CLI

codex mcp add openbudget --url https://api.openbudget.sh/mcp
codex mcp login openbudget

または、~/.codex/config.toml に追加します。

[mcp_servers.openbudget]
url = "https://api.openbudget.sh/mcp"

詳しいガイド：codex · codex-cli

その他の MCP クライアント

Streamable HTTP トランスポートを使ってリモート／カスタム MCP サーバーを追加し、https://api.openbudget.sh/mcp を指定します。ほとんどのクライアントは、上記の Cursor のセクションに示されている mcpServers の JSON 形式も使用できます。最初の呼び出し時にブラウザーが開き、サインインしてアクセスを承認できます。

詳しいガイド：openbudget.sh/connect-ai/other

---

質問できる内容

このサーバーには 22 個のツールが用意されており、それぞれのライブデモを openbudget.sh/tools で確認できます。ツール名を指定して呼び出すことはほとんどありません。自然言語で質問すれば、クライアントが適切なツールを選びます。

基本ツール

ツール	機能
list_accounts	残高、金融機関、正規化された純資産の表示を含む、リンク済みのすべての口座を取得します。
search_transactions	テキスト、カテゴリ、口座、日付範囲、金額で取引を検索・絞り込みます。Plaid が情報を提供している場合は、決済済み取引へのリンクや加盟店の所在地の詳細も含まれます。
get_liabilities	クレジットカード、学生ローン、住宅ローンの年利率、支払期日、最低支払額、完済データを取得します。
get_liability_history	年利率の変動、残高の推移、年初来の利息など、負債の経時的な変化を取得します。
list_available_categories	取引カテゴリの分類体系全体を取得します。
list_categorization_rules	自動分類ルールを評価順に取得します。
update_transaction	(書き込み) 取引の再分類、メモの追加、分割、検索結果からの非表示を行います。
create_transaction	(書き込み) 現金、ギフトカード、ストアクレジットで支払った、銀行口座を通さない購入を記録します。
delete_transaction	(書き込み) 手動で作成した取引を削除します（銀行取引は代わりに update_transaction で非表示にします）。
upsert_manual_account	(書き込み) 現金用ウォレットやギフトカードの残高など、銀行口座を通さない手動口座を作成または更新します。
save_categorization_rule	(書き込み) 「ベビーシッターへの支払いは育児費用」のようなルールを一度作成すると、新しい取引にも適用されます。
delete_categorization_rule	(書き込み) ルールを削除します。
update_liability	(書き込み) クレジットカードやローンにメモを追加するか、残高を手動で上書きします。

投資家向けツール

Investor にはすべての基本ツールが含まれ、以下のツールが追加されます。

ツール	機能
search_investment_holdings	接続済みおよびカスタムの保有資産を、口座、ティッカー、名称、カテゴリ、情報源、または決済済みかどうかで絞り込み、価値、数量、名称、またはティッカーで並べ替えます。AI が配分、損益、集中度を計算するために必要なポジションデータを返します。
search_investment_transactions	購入、売却、配当、利息、拠出、引き出し、手数料、税金、不動産取引、調整を検索します。
list_available_investment_categories	保有資産と投資活動、それぞれのカテゴリ分類体系を返します。
update_investment_holding	(書き込み) 保有資産の分類、表示フィールドの変更、メモの管理を行います。カスタム保有資産では、価値、数量、価格、取得原価、ティッカー、通貨、ステータスも変更できます。
update_investment_transaction	(書き込み) 投資活動の分類、メモの追加、または無視を行います。カスタムの活動では、金額、日付、数量、価格、手数料、ティッカー、通貨も変更できます。
create_investment_holding	(書き込み) 不動産、非公開企業の持分、収集品、オフラインのポジション、その他のカスタム資産を追加します。
delete_investment_holding	(書き込み) カスタム保有資産を削除します。接続済みの保有資産は金融機関から同期され続けます。
create_investment_transaction	(書き込み) 不動産の購入、分配、非公開企業への拠出、手数料、評価額の調整、その他のカスタム投資活動を追加します。
delete_investment_transaction	(書き込み) カスタムの投資活動を削除します。接続済みの活動は、代わりに無視できます。

取引結果には、計上済みの取引をそれ以前の保留中の記録に関連付ける pendingTransactionId と、住所、市区町村、地域、郵便番号、店舗番号、緯度、経度を含む構造化された location が含まれる場合があります。チップや事前承認によって決済金額が変わった場合でも、これらのフィールドを使うことでレシートとの照合を確実に行えます。

プロンプトの例

• 「先月、レストランでいくら使いましたか？ その前の月と比べてどうですか？」
• 「3月のデンバー旅行で、航空券、ホテル、食事、ライドシェアを含めて、合計いくらかかりましたか？」
• 「支払っているサブスクリプションをすべて見つけて、月ごとの合計を計算してください。」
• 「現在、すべての口座を合わせた純資産はいくらですか？」
• 「各クレジットカードの年利はいくらですか？ 次回の支払日はいつですか？」
• 「Elena への Venmo の支払いを育児費に分類して、ルールとして登録してください。」
• 「今晩、ベビーシッターに現金で 60 ドルを支払いました。育児費として記録してください。」
• 「200 ドル分の Amazon ギフトカードを追跡して、先ほど使った 45 ドルを記録してください。」
• 「銀行口座、カード、ローン、証券口座、退職口座、不動産を合わせた純資産はいくらですか？」
• 「過去 3 か月間に、いくら使い、いくら貯蓄し、いくら投資しましたか？ 月ごとにどのように変化しましたか？」
• 「賃貸物件を追加して、今月の分配金を記録してください。」

その他の例は examples/prompts.md をご覧ください。

---

読み取り専用の金融機関接続

銀行、証券会社、退職口座への接続には、読み取り専用のデータアクセスで Plaid を使用します。OpenBudget が金融機関の認証情報を取得したり、保存したりすることはありません。AI アシスタントが**お客様の金融機関で資金を移動したり、送金を開始したり、取引を行ったり、何かを変更したりすることはできません。**すべての書き込みは OpenBudget アカウント内で行われます。対象は、取引と投資のカテゴリ、メモ、無視フラグ、分割、ルール、負債の上書き、手動口座、カスタム保有資産、カスタム取引履歴です。各ツールは MCP アノテーション（readOnlyHint、destructiveHint）を宣言しているため、クライアントは各呼び出しで可能な操作を表示できます。

プライバシーと利用規約

OAuth により、AI クライアントがお客様自身の OpenBudget の金融データにアクセスできるようになります。利用規約、プライバシーポリシー、セキュリティの各ページをご覧ください。

ライセンス

このリポジトリの設定スニペットとドキュメントは、MIT ライセンスの対象です。

OpenBudget MCP サービスはホストされており、利用規約に従って運営されています。MIT ライセンスの対象は、このリポジトリの設定スニペットとドキュメントです。このリポジトリにはサーバーのソースコードは含まれていません。

リンク

• ウェブサイト：openbudget.sh
• ツールのデモ：openbudget.sh/tools
• 接続ガイド：openbudget.sh/connect-ai
• 料金：openbudget.sh/pricing
• Model Context Protocol：modelcontextprotocol.io