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íasget_single_category: Obtener una categoría específicacreate_category: Crear una nueva categoríaupdate_category: Actualizar una categoría existentedelete_category: Eliminar una categoría
Transacciones
get_all_transactions: Obtener todas las transacciones (con filtros)get_single_transaction: Obtener una transacción específicainsert_transactions: Insertar nuevas transaccionesupdate_transaction: Actualizar una transacción existente
Etiquetas
get_all_tags: Obtener todas las etiquetas
Activos
get_all_assets: Obtener todos los activos/cuentascreate_asset: Crear un nuevo activo/cuentaupdate_asset: Actualizar un activo existente
Presupuestos
get_budget_summary: Obtener resumen del presupuestoupsert_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 Plaidtrigger_plaid_fetch: Activar sincronización con Plaid
Criptomonedas
get_all_crypto: Obtener todos los activos cryptoupdate_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
.envy 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.