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, categoras, presupuestos y ms.

Caractersticas

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

• Usuario: Obtener informacin de la cuenta
• Categoras: Crear, leer, actualizar y eliminar categoras
• 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

Instalacin Super Simple

Opcin 1: Instalacin Automtica (Ms Fcil)

python install.py

Este script:

• Instala el paquete automticamente
• Te pide tu token de Lunch Money
• Configura Claude Desktop automticamente
• Todo listo para usar

Opcin 2: Instalacin Manual

pip install lunchmoney-mcp

Luego aade esta configuracin 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.

Obtn tu token de acceso:

1. Ve a https://my.lunchmoney.app/developers
2. Crea un nuevo token de acceso
3. salo en la configuracin de arriba

Instalacin desde el cdigo fuente

Si prefieres instalar desde el cdigo fuente:

1. Clona el repositorio:

   git clone <repository-url>
   cd lunchmoney-mcp
   

2. Instala:

   pip install -e .
   

3. Configura en Claude Desktop:

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

Ubicacin del archivo de configuracin:

• 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

1. Obtener informacin de usuario:

   "Mustrame la informacin de mi cuenta de Lunch Money"
   

2. Ver todas las categoras:

   "Lista todas mis categoras de Lunch Money"
   

3. Crear una nueva categora:

   "Crea una nueva categora llamada 'Entretenimiento' en Lunch Money"
   

4. Ver transacciones recientes:

   "Mustrame las transacciones del ltimo mes"
   

5. Crear una transaccin:

   "Aade una transaccin de $50 para 'Supermercado XYZ' en la categora 'Comida'"
   

6. Ver presupuesto:

   "Mustrame el resumen del presupuesto de este mes"
   

Herramientas disponibles

Usuario

• get_user: Obtener informacin del usuario y la cuenta

Categoras

• get_all_categories: Obtener todas las categoras
• get_single_category: Obtener una categora especfica
• create_category: Crear una nueva categora
• update_category: Actualizar una categora existente
• delete_category: Eliminar una categora

Transacciones

• get_all_transactions: Obtener todas las transacciones (con filtros)
• get_single_transaction: Obtener una transaccin especfica
• insert_transactions: Insertar nuevas transacciones
• update_transaction: Actualizar una transaccin existente

Etiquetas

• get_all_tags: Obtener todas las etiquetas

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 sincronizacin con Plaid

Criptomonedas

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

Desarrollo

Para contribuir al desarrollo:

1. Instala las dependencias de desarrollo:

   pip install -e ".[dev]"
   

2. Ejecuta las pruebas:

   pytest
   

3. Formatea el cdigo:

   black lunchmoney_mcp/
   

Seguridad

• Nunca compartas tu token de acceso de Lunch Money
• Guarda tu token en el archivo .env y asegrate de que est en tu .gitignore
• El servidor MCP se ejecuta localmente y no enva datos a servicios externos

Limitaciones

• La API de Lunch Money est en beta pblica, por lo que pueden haber cambios
• Algunas operaciones pueden tener lmites de velocidad
• Los cambios realizados a travs de la API son irreversibles

Soporte

Si encuentras problemas:

1. Verifica que tu token de acceso sea vlido
2. Consulta la documentacin oficial de Lunch Money
3. Revisa los logs del servidor MCP para errores especficos

Licencia

Este proyecto est bajo la licencia MIT. Ver el archivo LICENSE para ms detalles.

Enlaces relacionados

• Lunch Money
• Documentacin de la API de Lunch Money
• Model Context Protocol
• Claude Desktop