Lunch Money MCP Server

Un servidor MCP (Model Context Protocol) para la API de Lunch Money, que permite a los asistentes de IA interactuar con tu cuenta de Lunch Money para gestionar transacciones, categorías, presupuestos y más.

Características

Este servidor MCP proporciona acceso a las siguientes funcionalidades de Lunch Money:

Usuario: Obtener información de la cuenta
Categorías: Crear, leer, actualizar y eliminar categorías
Transacciones: Gestionar transacciones (crear, leer, actualizar, filtrar)
Etiquetas: Obtener todas las etiquetas
Activos: Gestionar cuentas/activos
Presupuestos: Obtener y actualizar presupuestos
Elementos recurrentes: Obtener transacciones recurrentes
Cuentas Plaid: Gestionar cuentas conectadas de Plaid
Criptomonedas: Gestionar activos crypto

Instalación Super Simple 🚀

Opción 1: Instalación Automática (Más Fácil)

python install.py

Este script:

✅ Instala el paquete automáticamente
✅ Te pide tu token de Lunch Money
✅ Configura Claude Desktop automáticamente
✅ Todo listo para usar

Opción 2: Instalación Manual

pip install lunchmoney-mcp

Luego añade esta configuración a tu archivo claude_desktop_config.json:

{
  "mcpServers": {
    "lunchmoney": {
      "command": "lunchmoney-mcp",
      "env": {
        "LUNCHMONEY_ACCESS_TOKEN": "tu_token_aqui"
      }
    }
  }
}

¡Eso es todo! 🎉 Tan simple como Playwright MCP.

Obtén tu token de acceso:

Ve a https://my.lunchmoney.app/developers
Crea un nuevo token de acceso
Úsalo en la configuración de arriba

Instalación desde el código fuente

Si prefieres instalar desde el código fuente:

Clona el repositorio:

git clone <repository-url>
cd lunchmoney-mcp

Instala:
```
pip install -e .
```

Configura en Claude Desktop:

{
  "mcpServers": {
    "lunchmoney": {
      "command": "lunchmoney-mcp",
      "env": {
        "LUNCHMONEY_ACCESS_TOKEN": "tu_token_aqui"
      }
    }
  }
}

Ubicación del archivo de configuración:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Uso

Una vez configurado, puedes usar Claude Desktop para interactuar con tu cuenta de Lunch Money. Aquí algunos ejemplos:

Ejemplos de uso

Obtener información de usuario:

"Muéstrame la información de mi cuenta de Lunch Money"

Ver todas las categorías:

"Lista todas mis categorías de Lunch Money"

Crear una nueva categoría:

"Crea una nueva categoría llamada 'Entretenimiento' en Lunch Money"

Ver transacciones recientes:

"Muéstrame las transacciones del último mes"

Crear una transacción:

"Añade una transacción de $50 para 'Supermercado XYZ' en la categoría 'Comida'"

Ver presupuesto:

"Muéstrame el resumen del presupuesto de este mes"

Herramientas disponibles

Usuario

get_user: Obtener información del usuario y la cuenta

Transacciones

get_all_transactions: Obtener todas las transacciones (con filtros)
get_single_transaction: Obtener una transacción específica
insert_transactions: Insertar nuevas transacciones
update_transaction: Actualizar una transacción existente

Activos

get_all_assets: Obtener todos los activos/cuentas
create_asset: Crear un nuevo activo/cuenta
update_asset: Actualizar un activo existente

Presupuestos

get_budget_summary: Obtener resumen del presupuesto
upsert_budget: Crear o actualizar datos del presupuesto

Elementos recurrentes

get_recurring_items: Obtener todos los elementos recurrentes

Cuentas Plaid

get_all_plaid_accounts: Obtener todas las cuentas Plaid
trigger_plaid_fetch: Activar sincronización con Plaid

Criptomonedas

get_all_crypto: Obtener todos los activos crypto
update_manual_crypto: Actualizar un activo crypto manual

Desarrollo

Para contribuir al desarrollo:

Instala las dependencias de desarrollo:
```
pip install -e ".[dev]"
```
Ejecuta las pruebas:
```
pytest
```
Formatea el código:
```
black lunchmoney_mcp/
```

Seguridad

Nunca compartas tu token de acceso de Lunch Money
Guarda tu token en el archivo .env y asegúrate de que esté en tu .gitignore
El servidor MCP se ejecuta localmente y no envía datos a servicios externos

Limitaciones

La API de Lunch Money está en beta pública, por lo que pueden haber cambios
Algunas operaciones pueden tener límites de velocidad
Los cambios realizados a través de la API son irreversibles

Soporte

Si encuentras problemas:

Verifica que tu token de acceso sea válido
Consulta la documentación oficial de Lunch Money
Revisa los logs del servidor MCP para errores específicos

Licencia

Este proyecto está bajo la licencia MIT. Ver el archivo LICENSE para más detalles.

Lunch Money MCP Server