Money Lover MCP Server
Money Lover MCP Server
Node.js-Implementierung eines Model Context Protocol (MCP)-Servers, der die inoffizielle Money Lover REST-API kapselt. Der Server stellt 27 MCP-Tools für Authentifizierung, Geldbörsen, Kategorien, Transaktionen, Ereignisse, Schulden und statische Konfiguration bereit – dies ermöglicht KI-Assistenten oder MCP-kompatiblen Clients das Abfragen und Verwalten von persönlichen Finanzdaten.
Funktionen
Automatische Authentifizierung über
EMAIL/PASSWORD-Umgebungsvariablen – für die meisten Tools ist keine Token-Übergabe erforderlich.23 Lese-Tools für Benutzerinformationen, Geldbörsen, Kategorien, Transaktionen, Ereignisse, Schulden, Symbole, Anbieter und statische Konfiguration.
4 Schreib-Tools: Erstellen, Aktualisieren und Löschen von Transaktionen, Geldbörsen und Kategorien.
Große Antworten werden automatisch gekürzt, um den LLM-Kontext überschaubar zu halten (konfigurierbar über den
limit-Parameter).Stdio-basierter Server, kompatibel mit Claude Code, Claude Desktop, Cursor und jedem MCP-Host.
Token-Caching pro E-Mail unter
~/.moneylover-mcp/mit automatischer Aktualisierung bei Authentifizierungsfehlern.
Related MCP server: Money Lover MCP Server
Voraussetzungen
Node.js 22 oder neuer.
Money Lover-Zugangsdaten.
Installation
npm installVerwendung
Starten Sie den MCP-Server über stdio:
npm startProjektbezogene Konfiguration (Claude Code)
Fügen Sie .mcp.json im Projektstammverzeichnis hinzu:
{
"mcpServers": {
"mcp-moneylover": {
"command": "node",
"args": ["/absolute/path/to/moneylover-mcp/src/server.js"],
"env": {
"EMAIL": "your@email.com",
"PASSWORD": "your-password"
}
}
}
}Und aktivieren Sie es in .claude/settings.json:
{ "enabledMcpjsonServers": ["mcp-moneylover"] }Globale Konfiguration (Claude Desktop / Cursor)
{
"mcpServers": {
"mcp-moneylover": {
"command": "npx",
"args": ["@ferdhika31/moneylover-mcp@latest"],
"env": {
"EMAIL": "your@email.com",
"PASSWORD": "your-password"
}
}
}
}Verfügbare Tools
Auth
Tool | Beschreibung | Argumente |
| Ruft ein JWT-Token ab. |
|
Benutzer
Tool | Beschreibung | Argumente |
| Mit der Sitzung verknüpftes Profil. | — |
| Geräte und aktive Sitzungen. | — |
| Erweiterte Profildaten. | — |
Geldbörsen (Wallets)
Tool | Beschreibung | Argumente |
| Alle Geldbörsen auflisten. | — |
| Saldoübersicht für eine Geldbörse. |
|
| Mit anderen Benutzern geteilte Geldbörsen. | — |
| Ausstehende Einladungen zur Freigabe. | — |
| Eine neue Geldbörse erstellen. |
|
| Name, Symbol oder Währung der Geldbörse aktualisieren. |
|
| Eine Geldbörse dauerhaft löschen. |
|
Kategorien
Tool | Beschreibung | Argumente |
| Kategorien für eine bestimmte Geldbörse. |
|
| Alle Kategorien über alle Geldbörsen hinweg. | optional |
| Eine Kategorie in einer Geldbörse erstellen. |
|
| Eine Kategorie umbenennen oder deren Symbol ändern. |
|
| Eine Kategorie löschen. |
|
Transaktionen
Tool | Beschreibung | Argumente |
| Transaktionen in einem Datumsbereich. |
|
| Eine Transaktion erstellen. Kategorie-IDs aus |
|
| Eine Transaktion aktualisieren. Die API erfordert bei jeder Bearbeitung die vollständige Nutzlast – rufen Sie die Transaktion zuerst ab, wenn Sie aktuelle Werte benötigen. |
|
| Eine Transaktion löschen. |
|
| Freitextsuche mit optionalen Filtern. | optional |
| Als Schulden/Darlehen markierte Transaktionen. | — |
| Zugehörige Transaktionen nach ID-Liste. |
|
| Zugehörige Transaktionen für eine Kategorie. |
|
| Zugehörige Transaktionen für eine Geldbörse. |
|
| Verfügbare Suchfilteroptionen. | optional |
Statik & Konfiguration
Tool | Beschreibung | Argumente |
| Sparziele/Ereignisse für eine Geldbörse. |
|
| Offene Schulden in einer Geldbörse. |
|
| Metadaten des Symbolpakets. | optional |
| Unterstützte Bankanbieter. | — |
| Währungskatalog. | optional |
| Snapshot der USD-basierten Wechselkurse. | — |
| Sonstige Laufzeitkonfiguration. | — |
Beispiele für die Tool-Verwendung
Beispiele für Prompts, erforderliche vs. optionale Felder, Fallstricke und gängige mehrstufige Muster für jedes Tool: docs/examples.md.
Bibliotheksverwendung
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');Testen
Unit-Tests
Gemockte Unit-Tests – keine Live-API-Aufrufe erforderlich:
npm testIntegrationstests (mcp-tester)
mcp-tester ist ein auf ReAct-Agenten basierendes MCP-Testframework. Es startet den Server, steuert ein LLM zur Ausführung von Tools als Reaktion auf natürlichsprachliche Prompts und prüft, ob die korrekten Tools mit den korrekten Argumenten aufgerufen wurden.
Installation
pipx install --index-url https://pypi.artifacts.furycloud.io/simple/ mcp-testerKonfiguration
tests/mcp-tester/mcps.json – verweisen Sie auf den lokalen Server mit Ihren Zugangsdaten:
{
"mcp-moneylover": {
"command": "node",
"args": ["/absolute/path/to/src/server.js"],
"transport": "stdio",
"env": {
"EMAIL": "your@email.com",
"PASSWORD": "your-password"
}
}
}Ausführung
mcp-tester run-tests \
--mcps tests/mcp-tester/mcps.json \
--model gpt-4o-mini \
--concurrent-runs 3 \
tests/mcp-tester/read-tools.yamlErgebnisse
tests/mcp-tester/read-tools.yaml enthält 25 Integrationstests, die jedes Lese-Tool abdecken:
total 25, success 25, failures 0Die wichtigsten Entscheidungen, die die Tests stabil machen:
Kein Token-Parameter bei Lese-Tools – das Offenlegen eines optionalen
token-Feldes führte dazu, dass LLMs Geldbörsen-IDs dort einfügten. Der Server authentifiziert sich automatisch über Umgebungsvariablen.Antwortkürzung – mehrere Endpunkte geben Hunderttausende von Datensätzen aus der gemeinsam genutzten MoneyLover-Datenbank zurück. Tools akzeptieren einen
limit-Parameter (Standard: 20–100), um den LLM-Kontext unter Kontrolle zu halten.Dict-Wrapping – alle Tool-Antworten geben ein JSON-Objekt zurück (niemals ein reines Array), damit die Validierung des MCP-Frameworks erfolgreich ist.
Schreib-Tool-Tests (mcp-tester)
Drei zusätzliche YAML-Dateien testen den vollständigen CRUD-Lebenszyklus für Geldbörsen, Kategorien und Transaktionen in drei aufeinanderfolgenden Phasen. Jede Phase führt alle drei Ressourcentypen gleichzeitig aus.
Datei | Phase | Tests |
| Erstellen |
|
| Bearbeiten |
|
| Löschen |
|
Führen Sie die Phasen nacheinander aus – jede hängt von der vorherigen ab:
# 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.yamlErgebnisse über alle drei Phasen hinweg:
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 0Die wichtigsten Designentscheidungen für Schreib-Tool-Tests:
Erkennung vor Mutation – Tests zum Bearbeiten und Löschen weisen den Agenten an, zuerst ein Lese-Tool (
get_wallets,get_categories,get_transactions) aufzurufen, um das Ziel anhand des Namens zu finden, und dann das Mutations-Tool aufzurufen. Dies spiegelt das reale Verhalten von Agenten wider, bei denen IDs nicht im Voraus bekannt sind.args: !anyfür Schreib-Tool-Assertionen – Das Framework erfordert eine exakte Übereinstimmung der Argumente. Schreib-Tools akzeptieren optionale Felder (icon,withusw.), die der Agent nach eigenem Ermessen einfügen kann;!anyüberprüft, ob das Tool aufgerufen wurde und erfolgreich war, ohne bei harmlosen Extras zu scheitern. Assertionen für Lese-Tools können exakte Argumentübereinstimmungen verwenden, da deren Schemata keine optionalen Felder enthalten, die das LLM spontan hinzufügen würde.Vorhersehbare Bezeichner – Testressourcen verwenden feste Namen (
MCP-Test-Wallet,MCP-Test-Category) und eine feste Notiz (MCP test transaction), damit der Agent sie während der Bearbeitungs- und Löschphasen anhand des Namens finden kann, ohne den Status zwischen Testläufen teilen zu müssen.Vollständige Payload-Bearbeitungs-Assertionen –
edit_transactionist ein Vorgang, der den gesamten Datensatz ersetzt; der Test-Prompt weist den Agenten an, zuerst die vorhandene Transaktion abzurufen (get_transactions) und alle aktuellen Feldwerte zu übernehmen, wobei nur die Notiz geändert wird. Dies validiert das mehrstufige Denken, das die Tool-Beschreibung erfordert.
Sicherheitshinweise
Committen Sie niemals echte Zugangsdaten oder Token.
Zwischengespeicherte Token befinden sich in
~/.moneylover-mcp/und sind auf den aktuellen Benutzer beschränkt.Löschen Sie dieses Verzeichnis, um alle zwischengespeicherten Sitzungen zu widerrufen.
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-