経費トラッカーMCPサーバー

Claudeを通じて個人の経費を記録・一覧表示・集計・削除できる、軽量なローカルMCP（Model Context Protocol）サーバーです。アプリも手動のスプレッドシート入力も不要で、自然な会話だけで完結します。

FastMCPで構築され、ローカルのSQLiteデータベースをバックエンドに使用しています。

なぜ作ったか

ほとんどの経費管理アプリは使い勝手が悪いものです。タップ数が多すぎる、カテゴリが固定されている、コーヒー1杯の記録にすらサブスクリプションが必要、などなど。このサーバーはClaudeを経費トラッカーに変えます。使った金額を伝えるだけで保存され、いつでもカテゴリ別の内訳を即座に確認できます。

Related MCP server: Expense Tracker MCP Server

機能

• 経費の追加 — 日付、カテゴリ、金額、サブカテゴリ、メモ付きで記録

• 経費の一覧表示 — 日付範囲を指定して表示

• 支出の集計 — カテゴリ別に集計（特定のカテゴリに絞り込みも可能）

• 経費の削除 — IDを指定して削除

• データは単一のSQLiteファイルにローカル保存 — 完全にプライベートで、クラウド同期なし

必要条件

• Python 3.10+

• fastmcp

依存関係をインストール:

pip install fastmcp

セットアップ

1. サーバースクリプト（例: expense_server.py）をマシンの恒久的な場所に保存します。

2. 初回実行時に、同じディレクトリにexpenses.dbが自動的に作成されます — 手動でのDBセットアップは不要です。

3. Claude Desktopの設定ファイルに追加します:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "expense-tracker": {
         "command": "python",
         "args": ["/full/absolute/path/to/expense_server.py"]
       }
     }
   }

   スクリプトへの絶対パスを使用してください。仮想環境を使用している場合は、commandをシステムのpythonではなく、その環境のPythonバイナリに指定してください。

4. Claude Desktopを再起動します。以下の4つのツールが利用可能として表示されるはずです。

ツール

日付はYYYY-MM-DD形式で指定してください。

使用例

サーバーが接続されたら、Claudeに自然に話しかけるだけです:

• 「今日の食料品450を記録して、サブカテゴリは野菜」

• 「昨日家賃に1200使った、メモ: 8月分の家賃」

• 「今月使ったものを全部見せて」

• 「2026年8月のカテゴリ別内訳は？」

• 「8月1日から8月15日までに食費にいくら使った？」

• 「経費#12を削除して、2回入力しちゃった」

データ保存

すべてのデータは、スクリプトと同じ場所に作成されるSQLiteファイルexpenses.dbに保存されます。他のどこにも送信されません — 完全にローカルでプライベートです。

スキーマ:

expenses
├── id            INTEGER PRIMARY KEY AUTOINCREMENT
├── date          TEXT NOT NULL
├── category      TEXT NOT NULL
├── amount        REAL NOT NULL
├── subcategory   TEXT DEFAULT ''
└── note          TEXT DEFAULT ''

データのバックアップ

すべてが1つのファイルに保存されるため、定期的にバックアップしてください:

cp expenses.db "expenses_backup_$(date +%Y%m%d).db"

macOS/Linuxではcronジョブ、Windowsではタスクスケジューラを使って週次で自動化することを検討してください。

注意点とヒント

• カテゴリ名に制約はないため、集計をきれいに保つには大文字小文字やスペルを統一してください（例: 常に「Groceries」とし、「groceries」と「Grocery」を混在させない）。

• 重複を避けたい場合は、新しいカテゴリを追加する前にClaudeに既存のカテゴリを一覧表示してもらいましょう。

• このサーバーには認証やネットワーク公開がありません — stdio経由でローカルのみで動作するため、追加のセキュリティ設定なしで安全に使用できます。

ライセンス

個人利用 — 自分のワークフローに合わせて自由にカスタマイズしてください。