Metadata-Version: 2.4
Name: mmex-mcp
Version: 0.1.0b1
Summary: MCP Server for Money Manager EX
Project-URL: Homepage, https://github.com/priosg/mmex_mcp
Project-URL: Repository, https://github.com/priosg/mmex_mcp
Project-URL: Documentation, https://github.com/priosg/mmex_mcp#readme
Project-URL: Issues, https://github.com/priosg/mmex_mcp/issues
License: MIT
License-File: LICENSE
Keywords: ai,claude,mcp,mmex,model-context-protocol,money-manager
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: mmex-lib>=0.1.0b1
Description-Content-Type: text/markdown

# MMEX MCP Server

MCP Server for Money Manager EX.

---

### 🌐 Documentación en Español (Spanish)
Toda la documentación detallada y guías en español están disponibles en:
👉 **[README_es.md](README_es.md)**

---

## Requirements

- Python 3.10+
- uv package manager
- mmex_lib installed (from `../mmex_lib`)
- A Money Manager EX database file (.mmb)

## Installation

```bash
cd mmex_mcp
uv sync
```

## Configuration

Set the `MMEX_DB_PATH` environment variable to point to your database:

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

For encrypted databases, also set `MMEX_DB_KEY`:

```bash
export MMEX_DB_KEY=your_password
```

## Testing

### Using MCP Inspector (Recommended)

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

```bash
cd mmex_mcp
MMEX_DB_PATH=/path/to/file.mmb uv run mcp dev src/mmex_mcp/server.py
```

This will:
1. Start the MCP server
2. Launch the MCP Inspector web UI
3. Open your browser at `http://localhost:6274`

**Note:** If the port is in use, kill existing processes:

```bash
pkill -f "mcp|inspector|node"
```

### Direct Execution

To run the server directly (for use with MCP clients):

```bash
cd mmex_mcp
MMEX_DB_PATH=/path/to/file.mmb uv run mmex-mcp
```

## Using with MCP Clients

### Claude Desktop

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

```json
{
  "mcpServers": {
    "mmex-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/mmex_mcp", "run", "mmex-mcp"],
      "env": {
        "MMEX_DB_PATH": "/path/to/your/database.mmb"
      }
    }
  }
}
```

### Other MCP Clients

For clients that support stdio MCP servers:

```bash
MMEX_DB_PATH=/path/to/file.mmb uv run mmex-mcp
```

## Available Tools

| Category | Tools |
|----------|-------|
| **Support** | `mmex_support_get_db_version` |
| **Currencies** | `mmex_currencies_list`, `mmex_currencies_get`, `mmex_currencies_by_symbol`, `mmex_currencies_create`, `mmex_currencies_update`, `mmex_currencies_delete` |
| **Tags** | `mmex_tags_list`, `mmex_tags_get`, `mmex_tags_create`, `mmex_tags_update`, `mmex_tags_delete`, `mmex_tags_for_reference`, `mmex_tags_link`, `mmex_tags_unlink` |
| **Categories** | `mmex_categories_list`, `mmex_categories_get`, `mmex_categories_subcategories`, `mmex_categories_create`, `mmex_categories_update`, `mmex_categories_delete` |
| **Payees** | `mmex_payees_list`, `mmex_payees_get`, `mmex_payees_create`, `mmex_payees_update`, `mmex_payees_delete` |
| **Accounts** | `mmex_accounts_list`, `mmex_accounts_get`, `mmex_accounts_balance`, `mmex_accounts_create`, `mmex_accounts_update`, `mmex_accounts_update_partial`, `mmex_accounts_delete` |
| **Assets** | `mmex_assets_list`, `mmex_assets_get`, `mmex_assets_create`, `mmex_assets_update`, `mmex_assets_delete` |
| **Stocks** | `mmex_stocks_list`, `mmex_stocks_get`, `mmex_stocks_create`, `mmex_stocks_update`, `mmex_stocks_delete` |
| **Transactions** | `mmex_transactions_list`, `mmex_transactions_get`, `mmex_transactions_create`, `mmex_transactions_update`, `mmex_transactions_delete`, `mmex_transactions_splits`, `mmex_transactions_add_split`, `mmex_transactions_update_split`, `mmex_transactions_delete_split`, `mmex_transactions_tags`, `mmex_transactions_link_tag`, `mmex_transactions_unlink_tag` |
| **Scheduled** | `mmex_scheduled_list`, `mmex_scheduled_get`, `mmex_scheduled_create`, `mmex_scheduled_update`, `mmex_scheduled_delete` |

**Total: 60 tools**

## Documentation

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

