zenmoney-mcp

zenmoney-mcp

ZenMoney 用の MCP サーバーです。MCP 対応の AI クライアント（Claude Desktop、Cursor など）から、ご自身の個人財務データにアクセスできます。

機能

ツール	説明
sync_data	ZenMoney とデータを同期します（最初に実行）
list_accounts	財布、カード、現金口座の一覧を表示します
list_categories	支出／収入カテゴリを階層構造で表示します
list_merchants	登録済みの店舗／支払先を表示します
list_transactions	最近の取引を表示、絞り込みします
add_expense	支出取引を追加します
add_income	収入取引を追加します
add_transfer	口座間で送金します（通貨をまたぐ送金にも対応）
update_transaction	既存の取引のカテゴリ、金額、日付、支払先、コメント、口座を変更します
suggest_category	支払先に基づいて自動提案されたカテゴリを取得します

前提条件

• Node.js >= 18
• ZenMoney アカウント
• zerro.app/token の API トークン

クイックスタート

クローンやビルドは不要です。MCP クライアントの設定に追加するだけです。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "zenmoney": {
      "command": "npx",
      "args": ["-y", "zenmoney-mcp"],
      "env": {
        "ZENMONEY_TOKEN": "your_token_here"
      }
    }
  }
}

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "zenmoney": {
      "command": "npx",
      "args": ["-y", "zenmoney-mcp"],
      "env": {
        "ZENMONEY_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Code

claude mcp add zenmoney -- npx -y zenmoney-mcp

your_token_here を zerro.app/token のトークンに置き換えてください。

Claude Desktop（MCPB バンドル）

JSON を編集せずにワンクリックでインストールする場合は、.mcpb バンドルをビルドし、Claude Desktop → 設定 → 拡張機能にドラッグしてください。

npm install
npm run pack:mcpb
# → dist/zenmoney-mcp-<version>.mcpb

インストール時に、Claude Desktop から ZenMoney トークンの入力を求められます（OS のキーチェーンに保存されます）。

ソースから

git clone https://github.com/artarasov/zenmoney-mcp.git
cd zenmoney-mcp
npm install
npm run build
cp .env.example .env  # add your token

使い方

設定が完了したら、会話を開始して、AI クライアントに次のように依頼します。

1. まず同期する — 「ZenMoney のデータを同期して」
2. 参照する — 「自分の口座を表示して」「カテゴリを一覧表示して」
3. 検索する — 「過去 7 日間の支出を表示して」「1 月 1 日から 31 日までの取引を一覧表示して」「食料品にいくら使った？」
4. 取引を追加する — 「今日、コーヒー代として 500 RUB の支出を追加して」
5. 送金する — 「Checking から Euro Card に 1000 USD を送金して。受取額は 920 EUR」
6. 誤りを修正する — 「昨日の Amazon の支出を Household カテゴリに変更して」「あの 500 RUB のコーヒーのコメントを変更して」

list_transactions は各取引の ID を出力し、update_transaction は ID を 1 つ、または複数のリストで受け取ります。そのため、1 回の呼び出しでまとめてカテゴリを変更できます。

貢献

PR を歓迎します。バグや機能リクエストについて、お気軽に issue を作成してください。

ライセンス

MIT