lunchmoney-mcp

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

Categorías

• get_all_categories: Obtener todas las categorías
• get_single_category: Obtener una categoría específica
• create_category: Crear una nueva categoría
• update_category: Actualizar una categoría existente
• delete_category: Eliminar una categoría

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

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 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.

Enlaces relacionados

• Lunch Money
• Documentación de la API de Lunch Money
• Model Context Protocol
• Claude Desktop