Budget Tracker by Smart Money

en • ru

Smart Money の Budget Tracker MCP

個人向け家計管理の Model Context Protocol サーバーです。OAuth で保護されており、自然な言葉で支出を記録し、口座、預金、予算、支出状況を追跡できます。

Smart Money の Budget Tracker MCP を使うと、AI アシスタントの中で家計簿を管理できます。Claude、ChatGPT、Cursor、VS Code、または CLI クライアントを Smart Money の Budget Tracker に接続し、「昨日、Kaspi からタクシー代として 4500 を記録して」や「今月、食費にいくら使った？」と話しかけると、アシスタントがアプリと同じ家計簿に記録します。

• サーバー URL： https://smart-money.ink/mcp
• トランスポート： Streamable HTTP
• 認証： PKCE を使用した OAuth 2.1
• ランディングページとセットアップ： smart-money.ink/claude

インストール

Smart Money の Budget Tracker MCP は、OAuth で保護されたリモートサーバーです。ローカルにインストールする必要はありません。MCP クライアントの設定に以下を追加してください。

{
  "mcpServers": {
    "smart-money": {
      "type": "http",
      "url": "https://smart-money.ink/mcp"
    }
  }
}

ワンクリックでインストール：

CLI クライアント（Claude Code、Gemini CLI、Codex CLI）および手動で追加するスニペットについては、対応クライアントをご覧ください。

クイックスタート

1. smart-money.inkで Smart Money の Budget Tracker アカウントを作成し、無料トライアルを開始します（プランとアクセスをご覧ください）。
2. smart-money.ink/claudeを開き、お使いのクライアント向けのセットアップ手順に従います。
3. ワンクリックインストール、CLI コマンド、または上記の手動 JSON スニペットを使用します。
4. クライアントに同意画面が表示されたら、OAuth で認証します。
5. アシスタントに自然な言葉でお金のことを相談します。

チャットでできること

• 💬 自然な言葉で記録 — taxi 4500 yesterday kaspi #trip は、金額、日付、口座、通貨、タグ、カテゴリーに解析されます。12k や 1.2m のような金額、yesterday や 3 days ago のような日付、あらゆる文字体系で書かれた口座名も認識されます。
• 📊 支出に関する回答 — 任意の期間について、収入、支出、貯蓄率、カテゴリー別内訳、利用額上位の加盟店を確認できます。
• 🏦 口座と残高 — カード、現金、銀行口座、預金、クレジットカード（負債として計上）、投資、電子ウォレットに対応しています。複数通貨に対応し、日付時点の為替レートを適用して基準通貨で合計します。
• 💰 利息付き預金 — 基準ポイント単位の金利、利息計算の頻度、複利、または別の口座への利息支払いを設定できます。利息は実際の残高に基づいて毎日計算され、すべての利息計上に冪等性キーが付与されるため、二重に記録されることはありません。
• 🎯 予算 — 週、月、年単位の上限を設定し、支出額、残額、期間終了時の予測を確認できます。
• 📥 銀行の通知 — プッシュ通知のテキストを貼り付けると取引として記録されます。同じ通知を再インポートしても重複しません。
• 🏷️ カテゴリーとタグ — カテゴリーはフラットな構成で、1ステップで選択できます。タグはカテゴリーとは独立しています。未知の #tag はその場で作成され、削除済みのタグは重複して作成されずに復元されます。

ツール一覧

27 個のツールがあります。読み取りと書き込みは別々のツールで行います。confirm や dryRun フラグはなく、それぞれに title と readOnlyHint／destructiveHint の注釈が付いているため、クライアントはどの呼び出しで確認プロンプトを表示すべきかを判断できます。

カテゴリ	ツール
👀 プレビュー (読み取り専用)	preview_entry、preview_notifications、preview_interest — 書き込み前に解析結果を表示します
💸 取引	quick_add、add_transaction、list_transactions、update_transaction、delete_transaction、import_notifications
📊 レポート	summary — 期間ごとの収入、支出、貯蓄率、カテゴリ、上位の加盟店
🏦 口座	list_accounts、create_account、update_account、delete_account、accrue_interest
🗂️ カテゴリ	list_categories、create_category、update_category、delete_category
🏷️ タグ	list_tags、create_tag、update_tag、delete_tag
🎯 予算	list_budgets、create_budget、update_budget、delete_budget

削除は論理削除です。取引には deletedAt が設定され、すべてのデバイスで残高とレポートから除外されますが、インポートキーは保持されるため、同じ銀行通知を再インポートしても取引は復元されません。取引から参照されている口座やカテゴリは削除できません。コネクターでは代わりにアーカイブを提案するため、履歴が参照先を失うことはありません。

最新の正確な一覧を確認するには、https://smart-money.ink/mcp に対して tools/list を実行してください。

プランとアクセス

Smart Money の Budget Tracker は、無料トライアル付きの有料サービスです。コネクターは実際の台帳を読み書きするため、有効なサブスクリプションまたはトライアルが必要です。匿名で利用できるプランはありません。

	無料トライアル	サブスクリプション
料金	7 日間 $0、カード登録が必要	月額 $7.99
Web アプリ、同期、すべてのコネクターツール	✅	✅

トライアル中に料金が請求されることはなく、トライアル期間中に解約すれば料金は発生しません。Settings → Subscription からいつでも解約できます。サブスクリプションの期限が切れるとアプリはロックされますが、記録は削除されません。ブラウザーに残り、引き続きエクスポートできます。現在の利用規約：smart-money.ink/terms。

有効なサブスクリプションがない状態でツールを呼び出すと、ツールの結果にその旨が表示され、アプリの設定が案内されます。

対応クライアント

• Claude（Web およびデスクトップ）— Settings → Connectors → Add custom connector
• ChatGPT — Settings → Connectors → OAuth を使用するカスタム MCP コネクター
• Cursor — ディープリンクからワンクリックでインストール、または ~/.cursor/mcp.json
• VS Code — ディープリンクからワンクリックでインストール、または .vscode/mcp.json
• Claude Code（CLI） — claude mcp add --transport http smart-money https://smart-money.ink/mcp
• Gemini CLI — gemini mcp add --transport http smart-money https://smart-money.ink/mcp
• Codex CLI — codex mcp add smart-money --url https://smart-money.ink/mcp
• 汎用 HTTP MCP クライアント — URL を指定すると、OAuth の検出が自動的に行われます

クライアントごとの詳しい手順：docs/setup.md。

Cursor プラグイン

このリポジトリは Cursor プラグインでもあります。MCP サーバー（smart-money）を 1 つ提供し、ルール、スキル、エージェント、フックは提供しません。

.cursor-plugin/plugin.json   ← plugin manifest
mcp.json                     ← the MCP server it contributes
assets/logo.svg              ← plugin logo

設定は不要です。API キーや環境変数も必要ありません。サーバーが OAuth 2.1 メタデータを公開し、クライアントが動的に登録され、初回使用時に同意画面が開きます。

プロンプトの例

入力しながら記録

「昨日のタクシー 4500 kaspi #trip」

→ 1件の取引として解析・保存されます。金額、日付、口座、タグが記録されます。プレビューツールで、先に解析結果を確認できます。

お金の使い道を確認

「今月の食費はいくらで、予算と比べるとどうですか？」

→ カテゴリー別の内訳に加え、予算の支出額、残額、月末の予測を確認できます。

預金

「預金に発生した利息を計上してください。」

→ 実際の残高に基づいて日ごとに発生した利息を計上します。冪等性があるため、2回実行しても追加で計上されることはありません。

銀行の通知

(銀行のプッシュ通知をまとめて貼り付けます) 「これを取引に変換してください。」

→ 取引として解析され、すでにインポート済みのものはスキップされます。

その他の例：docs/examples.md。

認証とデータ

認証にはPKCEを使用するOAuth 2.1を採用しています。アシスタントは、あなたのBudget Tracker by Smart Moneyアカウントに紐づくトークンを取得し、コネクターはあなたとして読み取りと書き込みを行います。行レベルセキュリティとサブスクリプションの確認は、ウェブアプリとまったく同じように適用されます。RFC 9728に準拠したディスカバリーにより、認証されていない状態で/mcpを呼び出すと、https://smart-money.ink/.well-known/oauth-protected-resource/mcpを示す401が返され、そこから認可サーバーが見つかります。

トークンは、いつでもBudget Tracker by Smart Moneyアプリから取り消すことができます。OAuthフローの詳細：docs/oauth.md。データの取り扱い：smart-money.ink/privacy。

トラブルシューティング

接続、OAuth、ツール呼び出しに関するよくあるエラー：docs/troubleshooting.md。

このサーバーの掲載先

レジストリやディレクトリへの掲載情報、および公開方法：docs/registries.md。

プロジェクトリンク

• 製品：smart-money.ink
• セットアップページ：smart-money.ink/claude
• MCP サーバー：https://smart-money.ink/mcp
• 課題：github.com/ultraza4/smart-money-mcp/issues

ライセンス

MIT — LICENSEを参照してください。

---

@ultraza4が作成しました。Budget Tracker by Smart Moneyは、ホスト型の個人向け家計管理サービスです。このリポジトリには、公開MCPサーバーのドキュメントとマニフェストが含まれています。サーバーのソースコードは公開されていません。