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 목록별 관련 거래. |
|
| 카테고리별 관련 거래. |
|
| 지갑별 관련 거래. |
|
| 사용 가능한 검색 필터 옵션. | 선택 사항 |
정적 및 구성
도구 | 설명 | 인수 |
| 지갑의 저축 목표/이벤트. |
|
| 지갑의 미결 부채. |
|
| 아이콘 팩 메타데이터. | 선택 사항 |
| 지원되는 은행 제공자. | — |
| 통화 카탈로그. | 선택 사항 |
| USD 기반 환율 스냅샷. | — |
| 기타 런타임 구성. | — |
도구 사용 예시
모든 도구에 대한 프롬프트 예시, 필수 vs 선택 필드, 주의 사항 및 일반적인 다단계 패턴: 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)를 허용합니다.Dict 래핑 — 모든 도구 응답은 JSON 객체를 반환하여(배열만 반환하지 않음) MCP 프레임워크 유효성 검사를 통과합니다.
쓰기 도구 테스트 (mcp-tester)
세 개의 추가 YAML 파일이 3단계 순차적 단계에 걸쳐 지갑, 카테고리 및 거래에 대한 전체 CRUD 수명 주기를 테스트합니다. 각 단계는 세 가지 리소스 유형을 모두 동시에 실행합니다.
파일 | 단계 | 테스트 |
| 생성 |
|
| 편집 |
|
| 삭제 |
|
단계를 순서대로 실행하세요. 각 단계는 이전 단계에 의존합니다:
# 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.yaml세 단계 모두에 대한 결과:
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-