Skip to main content
Glama
moneylover-mcp

moneylover-mcp

moneylover-mcp

License: MIT GitHub stars GitHub forks Last commit Repo size Top language

An unofficial Model Context Protocol (MCP) server for MoneyLover, exposed over stdio for MCP-compatible clients.

MoneyLover provides no official public API. This server uses the unofficial web API employed by the MoneyLover web application. It may cease to function if that API changes.

Contents

Related MCP server: wallet-mcp

Requirements

  • Node.js. The project does not pin a minimum version in package.json (no engines field).

  • A MoneyLover account. No official public API is used; see Security.

Features

  • Wallet, category, and transaction retrieval.

  • Transaction creation, with category identifiers resolved to the global form required by the transaction endpoint.

  • Token caching with automatic refresh on expiry, when environment credentials are supplied.

Quick start

npm install
npm start
{
  "mcpServers": {
    "moneylover": {
      "command": "node",
      "args": ["/path/to/moneylover-mcp/src/server.js"],
      "env": {
        "EMAIL": "you@example.com",
        "PASSWORD": "your-password"
      }
    }
  }
}

A token argument to any tool overrides environment authentication.

Verify it works by calling get_wallets from your MCP client — it should list your MoneyLover wallets. If calls fail with error 706, see Refreshing an expired token.

Tools

Tool

Description

login

Authenticate and cache an access token.

get_user_info

Retrieve the authenticated user profile.

get_wallets

List wallets.

get_categories

List categories for a wallet.

get_transactions

List transactions for a wallet over a date range.

add_transaction

Create a transaction in a wallet.

Refreshing an expired token

The server only auto-refreshes on error 717 / token_device_not_found. If calls start failing with error 706 (Not authorized), fetch a fresh token with the standalone script (Python 3, standard library only; the password is prompted with getpass and never stored):

python3 scripts/refresh_token.py --email you@example.com

It runs the same two-step login as the server, verifies the token with wallet/list, and caches it at ~/.moneylover-mcp/<base64url(email)>.json (directory 0700, file 0600). Its tests are mocked and need no network:

python3 test/refresh_token.test.py

Security

  • Only MoneyLover hosts are contacted: https://web.moneylover.me/api and https://oauth.moneylover.me/token.

  • Runtime dependencies are limited to @modelcontextprotocol/sdk and zod.

  • Access tokens are cached as plaintext JSON in ~/.moneylover-mcp/<base64url(email)>.json (directory 0700, file 0600). Delete that directory to revoke stored sessions.

  • No .env file is loaded. Credentials are taken only from the host environment or explicit tool arguments.

Development

npm test

Contributing

Issues and pull requests are welcome. Please describe the problem or change clearly, keep changes focused, and include test evidence where applicable.

Releases

See Releases for published versions. Current release: v0.1.0 (initial release).

License

MIT. This project is not affiliated with, endorsed by, or connected to MoneyLover.

Available Tools

6 tools
add_transactionAdd TransactionB

Create a new transaction in a wallet. categoryId may be a wallet-specific id from get_categories or a global category id; it is translated to the global id the current API expects.

Inputs: date (required), amount (required), walletId (required), categoryId (required), +3 more.

get_categoriesGet CategoriesB

List categories for a wallet. Note: the ids returned here are wallet-specific; add_transaction translates them to global ids automatically.

Inputs: walletId (required), token.

get_transactionsGet TransactionsC

Fetch transactions for a wallet between two dates (YYYY-MM-DD).

Inputs: endDate (required), walletId (required), startDate (required), token.

get_user_infoGet User InfoB

Retrieve the Money Lover user profile associated with the token.

Inputs: token.

get_walletsGet WalletsB

List wallets available to the authenticated user.

Inputs: token.

loginLoginB

Authenticate using Money Lover credentials to retrieve a JWT token (cached locally).

Inputs: email (required), password (required).

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 6 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: authentication, user profile, wallets, categories, transaction listing, and transaction creation. There is no meaningful overlap in purpose, and the descriptions make the boundaries clear.

    Naming Consistency4/5

    All names use snake_case and mostly follow a verb_noun pattern (get_user_info, get_wallets, add_transaction). The exception is 'login', which is a single verb rather than verb_noun, but it remains clear and readable.

    Tool Count5/5

    Six tools is well-scoped for a focused Money Lover client covering authentication, profile, wallets, categories, and transactions. Each tool has a clear role, and there is no unnecessary bloat.

    Completeness3/5

    The surface covers login, lookup, and adding a transaction, but notable lifecycle operations are missing: there is no update or delete for transactions, and no create/update/delete for wallets or categories. These gaps could cause agent failures when users need to correct or manage existing data.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • 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
      Not graded
      quality
      D
      maintenance
      MCP server for the BudgetBakers Wallet REST API, enabling management of transactions, accounts, categories, budgets, labels, and more through natural language.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides tools to read Money Lover account data and add transactions, with features for previewing, duplicate detection, reconciliation, and safe batch import of bank/card statement JSON via an MCP client.
      8
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables full CRUD and lending management for Money Lover transactions, wallets, categories, and lending records via MCP, with both local and HTTP transports.
      96 npm
      MIT