Skip to main content
Glama
thanquannguyen

moneylover-mcp

moneylover-mcp

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.

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.

Related MCP server: wallet-mcp

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.

Usage

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.

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

License

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    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
    17 npm
    6
    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.
    11 npm
    MIT
  • A
    license
    A
    quality
    A
    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.
    876 npm
    MIT