Skip to main content
Glama

Lunch Money MCP Server

by MatiasL13

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:

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

Instalación desde el código fuente

Si prefieres instalar desde el código 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" } } } }

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

  1. Obtener información de usuario:
    "Muéstrame la información de mi cuenta de Lunch Money"
  2. Ver todas las categorías:
    "Lista todas mis categorías de Lunch Money"
  3. Crear una nueva categoría:
    "Crea una nueva categoría llamada 'Entretenimiento' en Lunch Money"
  4. Ver transacciones recientes:
    "Muéstrame las transacciones del último mes"
  5. Crear una transacción:
    "Añade una transacción de $50 para 'Supermercado XYZ' en la categoría 'Comida'"
  6. 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:

  1. Instala las dependencias de desarrollo:
    pip install -e ".[dev]"
  2. Ejecuta las pruebas:
    pytest
  3. 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:

  1. Verifica que tu token de acceso sea válido
  2. Consulta la documentación oficial de Lunch Money
  3. 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

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that allows AI assistants to interact with Lunch Money accounts, enabling management of transactions, categories, budgets, and other financial data through natural language commands.

  1. Características
    1. Instalación Super Simple 🚀
      1. Opción 1: Instalación Automática (Más Fácil)
      2. Opción 2: Instalación Manual
      3. Obtén tu token de acceso:
    2. Instalación desde el código fuente
      1. Ubicación del archivo de configuración:
    3. Uso
      1. Ejemplos de uso
    4. Herramientas disponibles
      1. Usuario
      2. Categorías
      3. Transacciones
      4. Etiquetas
      5. Activos
      6. Presupuestos
      7. Elementos recurrentes
      8. Cuentas Plaid
      9. Criptomonedas
    5. Desarrollo
      1. Seguridad
        1. Limitaciones
          1. Soporte
            1. Licencia
              1. Enlaces relacionados

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  An MCP server that lets AI assistants interact with your Lunchmoney data, enabling natural language queries about transactions, budgets, and spending patterns.
                  Last updated -
                  4
                  3
                  8
                  TypeScript
                  MIT License
                • -
                  security
                  F
                  license
                  -
                  quality
                  A proof-of-concept Model Context Protocol server that enables LLM applications to interact with Uber Eats, allowing AI agents to browse and order food through natural language.
                  Last updated -
                  142
                  Python
                  • Linux
                  • Apple
                • A
                  security
                  F
                  license
                  A
                  quality
                  A Model Context Protocol server that allows AI assistants to query and analyze financial data through Ledger CLI, enabling tasks like financial reporting, budget analysis, and accounting.
                  Last updated -
                  9
                  21
                  Python
                  • Apple
                  • Linux
                • -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that connects AI assistants like Claude to Moneybird accounting software, enabling management of contacts, financial data, products, and business operations through natural language.
                  Last updated -
                  1
                  JavaScript
                  MIT License
                  • Apple

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/MatiasL13/lunchmoney-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server