Skip to main content
Glama
Money Lover MCP Server

Money Lover MCP Server

by juansebashr

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 install

Verwendung

Starten Sie den MCP-Server über stdio:

npm start

Projektbezogene 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

login

Ruft ein JWT-Token ab.

email, password

Benutzer

Tool

Beschreibung

Argumente

get_user_info

Mit der Sitzung verknüpftes Profil.

—

get_user_account

Geräte und aktive Sitzungen.

—

get_user_profile

Erweiterte Profildaten.

—

Geldbörsen (Wallets)

Tool

Beschreibung

Argumente

get_wallets

Alle Geldbörsen auflisten.

—

get_wallet_balance

Saldoübersicht für eine Geldbörse.

walletId

get_shared_wallets

Mit anderen Benutzern geteilte Geldbörsen.

—

get_awaiting_shared_wallets

Ausstehende Einladungen zur Freigabe.

—

add_wallet

Eine neue Geldbörse erstellen.

name, currencyId; optional icon

edit_wallet

Name, Symbol oder Währung der Geldbörse aktualisieren.

walletId, currencyId (API-erforderlich); optional name, icon

delete_wallet

Eine Geldbörse dauerhaft löschen.

walletId

Kategorien

Tool

Beschreibung

Argumente

get_categories

Kategorien für eine bestimmte Geldbörse.

walletId

get_all_categories

Alle Kategorien über alle Geldbörsen hinweg.

optional limit (Standard 50)

add_category

Eine Kategorie in einer Geldbörse erstellen.

walletId, name, icon (verwenden Sie get_icons für gültige Namen, z. B. icon_3), type (1=Einnahme, 2=Ausgabe)

edit_category

Eine Kategorie umbenennen oder deren Symbol ändern.

categoryId, icon (API-erforderlich, auch bei reiner Umbenennung); optional name

delete_category

Eine Kategorie löschen.

categoryId

Transaktionen

Tool

Beschreibung

Argumente

get_transactions

Transaktionen in einem Datumsbereich.

walletId, startDate, endDate (JJJJ-MM-TT)

add_transaction

Eine Transaktion erstellen. Kategorie-IDs aus get_categories werden automatisch in globale IDs aufgelöst.

walletId, categoryId, amount, date; optional note, with

edit_transaction

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. categoryId wird automatisch global aufgelöst.

transactionId, walletId, categoryId, amount, date; optional note, with

delete_transaction

Eine Transaktion löschen.

transactionId

search_transactions

Freitextsuche mit optionalen Filtern.

optional filters, limit (Standard 20)

get_debt_transactions

Als Schulden/Darlehen markierte Transaktionen.

—

get_related_transactions

Zugehörige Transaktionen nach ID-Liste.

ids (Array)

get_related_transactions_by_category

Zugehörige Transaktionen für eine Kategorie.

categoryId

get_related_transactions_by_wallet

Zugehörige Transaktionen für eine Geldbörse.

walletId

get_transaction_search_config

Verfügbare Suchfilteroptionen.

optional limit (Standard 20)

Statik & Konfiguration

Tool

Beschreibung

Argumente

get_events

Sparziele/Ereignisse für eine Geldbörse.

walletId; optional limit (Standard 50)

get_debts

Offene Schulden in einer Geldbörse.

walletId

get_icons

Metadaten des Symbolpakets.

optional pack (Standard "default")

get_linked_providers

Unterstützte Bankanbieter.

—

get_currencies

Währungskatalog.

optional limit (Standard 100)

get_exchange_rates

Snapshot der USD-basierten Wechselkurse.

—

get_other_config

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 test

Integrationstests (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-tester

Konfiguration

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.yaml

Ergebnisse

tests/mcp-tester/read-tools.yaml enthält 25 Integrationstests, die jedes Lese-Tool abdecken:

total 25, success 25, failures 0

Die 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

write-create.yaml

Erstellen

add_wallet, add_category, add_transaction

write-edit.yaml

Bearbeiten

edit_wallet, edit_category, edit_transaction

write-delete.yaml

Löschen

delete_wallet, delete_category, delete_transaction

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.yaml

Ergebnisse ü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 0

Die 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: !any für Schreib-Tool-Assertionen – Das Framework erfordert eine exakte Übereinstimmung der Argumente. Schreib-Tools akzeptieren optionale Felder (icon, with usw.), 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_transaction ist 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 tools
add_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_awaiting_shared_walletsGet Awaiting Shared WalletsB

List wallet share invitations pending acceptance.

Inputs: no named parameters.

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_shared_walletsGet Shared WalletsA

List wallets the authenticated user shares with others.

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

    A3.5/5.0

    Scored across 33 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      6
      23 npm
      7
      ISC
    • A
      license
      C
      quality
      B
      maintenance
      Enables 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.
      20
      167 npm
      22
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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
      -