MMEX MCP Server

MCP (Model Context Protocol) Server for interacting with Money Manager EX databases.

🌐 Documentación en Español (Spanish)

Toda la documentación detallada y guías en español están disponibles en: 👉 README_es.md

Requirements

• Python 3.10+
• A Money Manager EX database file (.mmb)

Installation

You can install the server directly from PyPI:

pip install mmex-mcp

Or using uv (recommended):

uv tool install mmex-mcp

Configuration

Set the MMEX_DB_PATH environment variable to point to your database:

export MMEX_DB_PATH=/path/to/your/database.mmb

For encrypted databases, also set MMEX_DB_KEY:

export MMEX_DB_KEY=your_password

Using with MCP Clients

OpenCode

{
    "mcp": {
        "mmex-mcp": {
            "enabled": true,
            "type": "local",
            "command": [
                "mmex-mcp"
            ],
            "environment": {
                "MMEX_DB_PATH": "/path/to/your/database.mmb"// Optional
            }
        }
    }
}

Claude Desktop

Since mmex-mcp is installed as a system package or via uv tool, you can configure Claude Desktop to use it directly.

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "mmex-mcp": {
      "command": "mmex-mcp",
      "env": {
        "MMEX_DB_PATH": "/path/to/your/database.mmb"//Optional
      }
    }
  }
}

Other MCP Clients

For clients that support stdio MCP servers:

MMEX_DB_PATH=/path/to/file.mmb mmex-mcp

Testing

Using MCP Inspector (Recommended)

The MCP Inspector provides a web UI to test all tools interactively:

MMEX_DB_PATH=/path/to/file.mmb npx @modelcontextprotocol/inspector mmex-mcp

This will:

1. Start the MCP server
2. Launch the MCP Inspector web UI
3. Open your browser at the provided localhost URL.

Available Tools

Total: 60 tools

Documentation

See docs/ for detailed documentation:

• docs/README.md - Overview
• docs/design.md - Technical design
• docs/implementation-plan.md - Implementation details
• docs/README_es.md - Visión General (Español)
• docs/design_es.md - Diseño Técnico (Español)
• docs/implementation-plan_es.md - Plan de Implementación (Español)

Development

If you want to contribute or build from source:

git clone https://github.com/PatricioRios/mmex_mcp
cd mmex_mcp
uv sync
MMEX_DB_PATH=/path/to/file.mmb uv run mcp dev src/mmex_mcp/server.py