Money Lover MCP Server
Money Lover MCP サーバー
非公式の Money Lover REST API をラップする、Model Context Protocol (MCP) サーバーの Node.js 実装です。このサーバーは、認証、ウォレット、カテゴリ、取引、イベント、負債、および静的設定をカバーする 27 個の MCP ツールを公開しており、AI アシスタントや MCP 対応クライアントが個人財務データを照会および管理できるようにします。
機能
EMAIL/PASSWORD環境変数による自動認証 — ほとんどのツールでトークンの受け渡しは不要です。ユーザー情報、ウォレット、カテゴリ、取引、イベント、負債、アイコン、プロバイダー、静的設定をカバーする 23 個の読み取りツール。
4 個の書き込みツール: 取引、ウォレット、カテゴリの作成、更新、削除。
LLM のコンテキストを管理しやすくするために、大きな応答は自動的に切り詰められます(
limitパラメータで設定可能)。Claude Code、Claude Desktop、Cursor、およびあらゆる MCP ホストと互換性のある Stdio ベースのサーバー。
~/.moneylover-mcp/配下でのメールごとのトークンキャッシュと、認証エラー時の自動更新。
Related MCP server: Money Lover MCP Server
前提条件
Node.js 22 以降。
Money Lover アカウントの資格情報。
インストール
npm install使用方法
Stdio 経由で MCP サーバーを起動します:
npm startプロジェクトスコープの設定 (Claude Code)
プロジェクトのルートに .mcp.json を追加します:
{
"mcpServers": {
"mcp-moneylover": {
"command": "node",
"args": ["/absolute/path/to/moneylover-mcp/src/server.js"],
"env": {
"EMAIL": "your@email.com",
"PASSWORD": "your-password"
}
}
}
}そして .claude/settings.json で有効にします:
{ "enabledMcpjsonServers": ["mcp-moneylover"] }グローバル設定 (Claude Desktop / Cursor)
{
"mcpServers": {
"mcp-moneylover": {
"command": "npx",
"args": ["@ferdhika31/moneylover-mcp@latest"],
"env": {
"EMAIL": "your@email.com",
"PASSWORD": "your-password"
}
}
}
}利用可能なツール
認証
ツール | 説明 | 引数 |
| JWT トークンを取得します。 |
|
ユーザー
ツール | 説明 | 引数 |
| セッションに関連付けられたプロファイル。 | — |
| デバイスとアクティブなセッション。 | — |
| 拡張プロファイルデータ。 | — |
ウォレット
ツール | 説明 | 引数 |
| すべてのウォレットを一覧表示します。 | — |
| ウォレットの残高概要。 |
|
| 他のユーザーと共有されているウォレット。 | — |
| 保留中の共有招待。 | — |
| 新しいウォレットを作成します。 |
|
| ウォレット名、アイコン、または通貨を更新します。 |
|
| ウォレットを完全に削除します。 |
|
カテゴリ
ツール | 説明 | 引数 |
| 特定のウォレットのカテゴリ。 |
|
| すべてのウォレットにわたる全カテゴリ。 | オプション |
| ウォレット内にカテゴリを作成します。 |
|
| カテゴリ名の変更またはアイコンの変更。 |
|
| カテゴリを削除します。 |
|
取引
ツール | 説明 | 引数 |
| 指定期間内の取引。 |
|
| 取引を作成します。 |
|
| 取引を更新します。API は編集のたびに完全なペイロードを要求します。現在の値が必要な場合は、まず取引を取得してください。 |
|
| 取引を削除します。 |
|
| オプションのフィルターを使用した自由形式の検索。 | オプション |
| 負債/ローンとしてフラグが立てられた取引。 | — |
| ID リストによる関連取引。 |
|
| カテゴリに関連する取引。 |
|
| ウォレットに関連する取引。 |
|
| 利用可能な検索フィルターオプション。 | オプション |
静的設定 & 設定
ツール | 説明 | 引数 |
| ウォレットの貯蓄目標/イベント。 |
|
| ウォレット内の未払い負債。 |
|
| アイコンパックのメタデータ。 | オプション |
| サポートされている銀行プロバイダー。 | — |
| 通貨カタログ。 | オプション |
| 米ドルベースの為替レートのスナップショット。 | — |
| その他のランタイム設定。 | — |
ツールの使用例
プロンプトの例、必須フィールドとオプションフィールド、注意点、およびすべてのツールに共通するマルチステップパターンの詳細: docs/examples.md
ライブラリの使用
import { MoneyloverClient } from './src/moneyloverClient.js';
const token = await MoneyloverClient.getToken(email, password);
const client = new MoneyloverClient(token);
const wallets = await client.getWallets();
const txns = await client.getTransactions(walletId, '2026-01-01', '2026-04-30');
await client.addTransaction({ walletId, categoryId, amount: '50000', date: '2026-04-18' });
await client.editTransaction('txn-id', { amount: '60000', note: 'updated' });
await client.deleteTransaction('txn-id');テスト
ユニットテスト
モック化されたユニットテスト — ライブ API 呼び出しは不要です:
npm test統合テスト (mcp-tester)
mcp-tester は、ReAct エージェントベースの MCP テストフレームワークです。サーバーを起動し、自然言語プロンプトに応答してツールを呼び出すように LLM を駆動し、正しい引数で正しいツールが呼び出されたことをアサートします。
インストール
pipx install --index-url https://pypi.artifacts.furycloud.io/simple/ mcp-tester設定
tests/mcp-tester/mcps.json — 資格情報を使用してローカルサーバーを指すようにします:
{
"mcp-moneylover": {
"command": "node",
"args": ["/absolute/path/to/src/server.js"],
"transport": "stdio",
"env": {
"EMAIL": "your@email.com",
"PASSWORD": "your-password"
}
}
}実行
mcp-tester run-tests \
--mcps tests/mcp-tester/mcps.json \
--model gpt-4o-mini \
--concurrent-runs 3 \
tests/mcp-tester/read-tools.yaml結果
tests/mcp-tester/read-tools.yaml には、すべての読み取りツールをカバーする 25 個の統合テストが含まれています:
total 25, success 25, failures 0テストを安定させるための重要な決定事項:
読み取りツールにトークンパラメータを含めない — オプションの
tokenフィールドを公開すると、LLM がそこにウォレット ID を注入してしまうためです。サーバーは環境変数を介して自動的に認証を行います。応答の切り詰め — 一部のエンドポイントは、共有 MoneyLover データベースから数十万件のレコードを返します。ツールは LLM のコンテキストを制御するために
limitパラメータ (デフォルト: 20–100) を受け入れます。辞書によるラップ — すべてのツール応答は JSON オブジェクトを返します(配列単体は返しません)。これにより、MCP フレームワークの検証を通過します。
書き込みツールのテスト (mcp-tester)
3 つの追加 YAML ファイルが、ウォレット、カテゴリ、取引の完全な CRUD ライフサイクルを 3 つの連続したフェーズでテストします。各フェーズで 3 つのリソースタイプすべてを同時に実行します。
ファイル | フェーズ | テスト |
| 作成 |
|
| 編集 |
|
| 削除 |
|
フェーズを順番に実行します。各フェーズは前のフェーズに依存します:
# Phase 1: Create
mcp-tester run-tests --mcps tests/mcp-tester/mcps.json --model gpt-4o-mini --concurrent-runs 3 tests/mcp-tester/write-create.yaml
# Phase 2: Edit (after Phase 1 passes)
mcp-tester run-tests --mcps tests/mcp-tester/mcps.json --model gpt-4o-mini --concurrent-runs 3 tests/mcp-tester/write-edit.yaml
# Phase 3: Delete (after Phase 2 passes)
mcp-tester run-tests --mcps tests/mcp-tester/mcps.json --model gpt-4o-mini --concurrent-runs 3 tests/mcp-tester/write-delete.yaml3 つのフェーズすべての結果:
Phase 1 (Create): total 3, success 3, failures 0
Phase 2 (Edit): total 3, success 3, failures 0
Phase 3 (Delete): total 3, success 3, failures 0書き込みツールテストの重要な設計決定:
変更前の探索 — 編集および削除テストでは、エージェントに対して、まず読み取りツール (
get_wallets,get_categories,get_transactions) を呼び出して名前でターゲットを特定し、その後に変更ツールを呼び出すよう指示します。これは、ID が事前にわかっていない現実のエージェントの動作を反映しています。書き込みツールのアサーションに
args: !anyを使用 — フレームワークは正確な引数の一致を要求します。書き込みツールは、エージェントが任意に含める可能性のあるオプションフィールド (icon,withなど) を受け入れます。!anyは、無害な追加要素で失敗することなく、ツールが呼び出され成功したことを検証します。読み取りツールのアサーションは、スキーマに LLM が自発的に追加するようなオプションフィールドがないため、正確な引数の一致を使用できます。予測可能な識別子 — テストリソースは固定名 (
MCP-Test-Wallet,MCP-Test-Category) と固定メモ (MCP test transaction) を使用するため、エージェントは編集および削除フェーズ中にテスト実行間で状態を共有することなく、名前でそれらを特定できます。完全ペイロード編集のアサーション —
edit_transactionは完全置換操作です。テストプロンプトは、エージェントに対して、まず既存の取引を取得 (get_transactions) し、現在のすべてのフィールド値を引き継ぎ、メモのみを変更するように指示します。これにより、ツールの説明で要求されるマルチステップの推論が検証されます。
セキュリティ上の注意
実際の資格情報やトークンをコミットしないでください。
キャッシュされたトークンは
~/.moneylover-mcp/に保存され、現在のユーザーのみに制限されます。キャッシュされたすべてのセッションを取り消すには、そのディレクトリを削除してください。
Available Tools
33 toolsadd_categoryAdd CategoryC
Create a new transaction category in a wallet.
Inputs: walletId (required), name (required), icon (required), type (required).
add_transactionAdd TransactionC
Create a new transaction in a wallet.
Inputs: walletId (required), categoryId (required), amount (required), date (required), +2 more.
add_walletAdd WalletC
Create a new Money Lover wallet.
Inputs: name (required), currencyId (required), icon.
delete_categoryDelete CategoryC
Permanently delete a category.
Inputs: categoryId (required).
delete_transactionDelete TransactionC
Permanently delete a transaction by its identifier.
Inputs: transactionId (required).
delete_walletDelete WalletC
Permanently delete a wallet and all its data.
Inputs: walletId (required).
edit_categoryEdit CategoryC
Rename a category or update its icon.
Inputs: categoryId (required), icon (required), name.
edit_transactionEdit TransactionA
Update an existing transaction. The API requires the full transaction payload on every edit, so you must supply walletId, categoryId, amount, and date (fetch the transaction with get_transactions first if you need the current values). categoryId should be the global category ID from get_all_categories or from an existing transaction response.
Inputs: transactionId (required), walletId (required), categoryId (required), amount (required), +3 more.
edit_walletEdit WalletC
Update a wallet name, icon, or currency.
Inputs: walletId (required), currencyId (required), name, icon.
get_all_categoriesGet All CategoriesA
List ALL categories across ALL wallets with no wallet filter. Use this instead of get_categories when no specific wallet is provided.
Inputs: limit.
get_categoriesGet CategoriesB
Retrieve categories for a specific wallet.
Inputs: walletId (required). Returns: categories
get_currenciesGet CurrenciesA
List all currencies supported by Money Lover (names, symbols, codes). Use this for currency metadata, not exchange rates.
Inputs: limit.
get_debtsGet DebtsB
List open debts or loans tracked in a specific wallet.
Inputs: walletId (required).
get_debt_transactionsGet Debt TransactionsB
List transactions flagged as debts or loans across the account.
Inputs: no named parameters.
get_eventsGet EventsC
List Money Lover events (savings goals, campaigns) associated with a wallet.
Inputs: walletId (required), limit.
get_exchange_ratesGet Exchange RatesB
Fetch the USD-based exchange rate snapshot used by Money Lover.
Inputs: no named parameters.
get_iconsGet IconsC
Fetch the icon pack used by Money Lover categories, wallets, and events.
Inputs: pack.
get_linked_providersGet Linked ProvidersA
List financial institution providers supported for linked accounts.
Inputs: no named parameters.
get_other_configGet Other ConfigB
Retrieve the small static configuration blob served under /other/config.
Inputs: no named parameters.
get_transactionsGet TransactionsC
Fetch transactions for a wallet between two dates.
Inputs: walletId (required), startDate (required), endDate (required).
get_transaction_search_configGet Transaction Search ConfigA
Return the saved configuration options (labels, with-parties, saved filters) available for use with the search_transactions tool.
Inputs: limit.
get_user_accountGet User AccountB
List devices and sessions tied to the Money Lover account.
Inputs: no named parameters.
get_user_infoGet User InfoB
Retrieve the Money Lover user profile associated with the provided token.
Inputs: no named parameters.
get_user_profileGet User ProfileB
Retrieve extended profile information for the current user.
Inputs: no named parameters.
get_wallet_balanceGet Wallet BalanceB
Fetch the current balance summary for a specific wallet.
Inputs: walletId (required).
get_walletsGet WalletsA
List all wallets accessible to the authenticated user.
Inputs: no named parameters. Returns: wallets
loginLogin to Money LoverA
Authenticate using Money Lover credentials to retrieve a JWT token.
Inputs: email (required), password (required). Returns: token
search_transactionsSearch TransactionsA
Free-form search across transactions using optional filters (walletId, categoryId, keyword, parties). Use this when no date range is given or when doing a keyword/label search instead of a date-range fetch.
Inputs: filters, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 33 tools
Most tools have distinct purposes with clear resource-action pairs, but some overlap exists: get_user_account, get_user_info, and get_user_profile could be confused, and get_related_transactions, get_related_transactions_by_category, and get_related_transactions_by_wallet have subtle distinctions that might cause misselection without careful reading of descriptions.
Tool names follow a highly consistent verb_noun pattern throughout, with clear action prefixes (add_, delete_, edit_, get_, login, search_) and descriptive nouns. There are no deviations in style or convention, making the set predictable and readable.
With 33 tools, the count feels heavy for a personal finance server, bordering on excessive. While it covers many features, it may overwhelm agents and could likely be streamlined without losing core functionality, placing it in the borderline range for appropriateness.
The tool surface provides comprehensive coverage for the Money Lover domain, including full CRUD operations for wallets, categories, and transactions, along with extensive querying, user management, and auxiliary features like debts, events, and search. No obvious gaps exist that would hinder agent workflows.
Maintenance
Related MCP Connectors
Personal finance for AI agents: accounts, budgets, goals, 9-strategy debt payoff, reports. OAuth 2.1
Log, query, and edit expenses, budgets, and accounts in Manilo (formerly Ledgy) from any MCP-compatible AI assistant.
Track expenses, budgets, balances, transfers, and multi-currency reports with OAuth-secured tools.
Log, query, and edit expenses, budgets, and accounts in Manilo from any MCP-compatible AI assistant.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with YNAB budgets through natural language. Supports managing accounts, categories, transactions, and budget months with 21 tools for comprehensive budget operations.-
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Money Lover personal finance app through unofficial REST API. Supports authentication, wallet management, transaction querying, and creating new transactions for expense tracking.623 npm7ISC
- AlicenseCqualityBmaintenanceEnables AI assistants to manage personal finances through the Realbyte Money Manager mobile app, providing transaction management, asset tracking, credit card monitoring, and financial analytics with 18 comprehensive tools.20167 npm22MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants and MCP clients to interact with personal finance data for transaction management, budgeting, recurring expenses, accounts, categories, tags, crypto, and balance history via LunchMoney's API.41 npm-