lunchmoney-mcp

@MatiasL13/lunchmoney-mcp

0 Stars 188 次浏览 MatiasL13 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

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:

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

Instalacin desde el cdigo fuente

Si prefieres instalar desde el cdigo 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"
      }
    }
  }
}

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

Obtener informacin de usuario:

"Mustrame la informacin de mi cuenta de Lunch Money"

Ver todas las categoras:

"Lista todas mis categoras de Lunch Money"

Crear una nueva categora:

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

Ver transacciones recientes:

"Mustrame las transacciones del ltimo mes"

Crear una transaccin:

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

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

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:

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

Verifica que tu token de acceso sea vlido
Consulta la documentacin oficial de Lunch Money
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

查看源码项目主页