# lunchmoney-mcp
## 基本信息
- Slug: `matiasl13-lunchmoney-mcp`
- Source: modelscope
- Publisher: @MatiasL13/lunchmoney-mcp
- Categories: 金融 / customer-data-platforms
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@MatiasL13/lunchmoney-mcp
## 简介
暂无描述。
## 安装提示

```bash
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 ```bash pip install lunchmoney-mcp
```

## MCP Server 详情

# Lunch Money MCP Server

Un servidor MCP (Model Context Protocol) para la [API de Lunch Money](https://lunchmoney.dev), 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)

```bash
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

```bash
pip install lunchmoney-mcp
```

Luego aade esta configuracin a tu archivo `claude_desktop_config.json`:

```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](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:**
   ```bash
   git clone <repository-url>
   cd lunchmoney-mcp
   ```

2. **Instala:**
   ```bash
   pip install -e .
   ```

3. **Configura en Claude Desktop:**
   ```json
   {
     "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:**
   ```bash
   pip install -e ".[dev]"
   ```

2. **Ejecuta las pruebas:**
   ```bash
   pytest
   ```

3. **Formatea el cdigo:**
   ```bash
   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](https://lunchmoney.dev)
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](https://lunchmoney.app)
- [Documentacin de la API de Lunch Money](https://lunchmoney.dev)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [Claude Desktop](https://claude.ai/desktop)