moneymanager-mcp 0.2.0

MCP stdio server for Realbyte Money Manager .mmbak backups.

moneymanager-mcp

MCP stdio server for querying Realbyte Money Manager .mmbak exports with AI clients.

The server reads a local .mmbak file, which is a ZIP-wrapped SQLite database, through the moneymanager-parser SDK. It exposes tools for filtered queries, schema inspection, category listing, accounts (names and balances), and currencies.

Install

pip install moneymanager-mcp

Run

Point the server at a backup file with MONEY_BACKUP or pass backup_path to each tool:

export MONEY_BACKUP=/path/to/backup.mmbak
moneymanager-mcp

Tools:

• query(backup_path=None, date_from=None, date_to=None, month=None, category=None, search=None, kind="expense", group_by=None, top=None, list_n=None, limit=24)
• schema(backup_path=None)
• list_categories(backup_path=None)
• accounts(backup_path=None)
• currency(backup_path=None)

Invalid or missing backups return a JSON error payload instead of crashing the server.

Client configuration

Claude Desktop example:

{
  "mcpServers": {
    "money-manager": {
      "command": "moneymanager-mcp",
      "env": {
        "MONEY_BACKUP": "/path/to/backup.mmbak"
      }
    }
  }
}

Generic stdio example:

{
  "command": "moneymanager-mcp",
  "args": [],
  "env": {"MONEY_BACKUP": "/path/to/backup.mmbak"}
}

Development

python3 -m venv .venv
. .venv/bin/activate
pip install -e '.[dev]'
ruff check .
ruff format --check .
mypy src
pytest --cov

Contributing

Issues and pull requests are welcome. Please use generated sample backups in tests rather than personal exports.

License

MIT © 2026 Shubham Sharma