Monarch Money

Accede y gestiona tus datos financieros y operaciones de Monarch Money.

GitHub

Prueba este MCPPatrocinado

Documentación

Monarch Money MCP Server

Archivado en favor del ahora oficialmente compatible Monarch Money Connector

Un servidor MCP (Model Context Protocol) que proporciona acceso a los datos financieros y operaciones de Monarch Money.

Características

Gestión de cuentas: Listar y recuperar información de cuentas
Operaciones de transacciones: Obtener transacciones con filtrado por rango de fechas, cuentas y categorías
Análisis de presupuesto: Acceder a datos de presupuesto e información sobre gastos
Gestión de categorías: Listar y gestionar categorías de transacciones
Seguimiento de objetivos: Acceder a objetivos financieros y su progreso
Seguimiento de patrimonio neto: Recuperar instantáneas del patrimonio neto a lo largo del tiempo

Instalación

Clona o descarga este servidor MCP
Instala las dependencias:
```
cd /path/to/monarch-money-mcp
uv sync
```

Configuración

Añade el servidor a tu archivo de configuración .mcp.json:

{
  "mcpServers": {
    "monarch-money": {
      "command": "/path/to/uv",
      "args": [
        "--directory", 
        "/path/to/monarch-money-mcp",
        "run",
        "python",
        "server.py"
      ],
      "env": {
        "MONARCH_EMAIL": "your-email@example.com",
        "MONARCH_PASSWORD": "your-password",
        "MONARCH_MFA_SECRET": "your-mfa-secret-key"
      }
    }
  }
}

Notas importantes:

Reemplaza /path/to/uv con la ruta completa a tu ejecutable uv (encuéntralo con which uv)
Reemplaza /path/to/monarch-money-mcp con la ruta absoluta al directorio de este servidor
Usa rutas absolutas, no rutas relativas

Obtención de tu secreto MFA

Ve a la configuración de Monarch Money y habilita la autenticación de dos factores (2FA)
Cuando se muestre el código QR, busca la opción "¿No puedes escanear?" o "Introducir manualmente"
Copia la clave secreta (será una cadena como T5SPVJIBRNPNNINFSH5W7RFVF2XYADYX)
Úsala como tu MONARCH_MFA_SECRET

Herramientas disponibles

`get_accounts`

Lista todas las cuentas con sus saldos y detalles.

`get_transactions`

Obtén transacciones con filtrado opcional:

start_date: Filtra transacciones desde esta fecha (YYYY-MM-DD)
end_date: Filtra transacciones hasta esta fecha (YYYY-MM-DD)
account_ids: Lista de IDs de cuentas para filtrar
category_ids: Lista de IDs de categorías para filtrar
limit: Número máximo de transacciones a devolver

`get_categories`

Lista todas las categorías de transacciones.

`get_budgets`

Obtén información de presupuesto y análisis de gastos.

`get_goals`

Lista los objetivos financieros y su progreso.

`get_cashflow`

Obtén datos de flujo de caja para el análisis de ingresos y gastos.

`get_investments`

Obtén detalles y rendimiento de cuentas de inversión.

`get_net_worth`

Obtén instantáneas del patrimonio neto a lo largo del tiempo.

Ejemplos de uso

Información básica de cuentas

Use the get_accounts tool to see all my accounts and their current balances.

Análisis de transacciones

Get all transactions from January 2024 using get_transactions with start_date "2024-01-01" and end_date "2024-01-31".

Seguimiento de presupuesto

Show me my current budget status using the get_budgets tool.

Gestión de sesiones

El servidor gestiona automáticamente las sesiones de autenticación:

Las sesiones se almacenan en caché en un directorio .mm para acelerar los inicios de sesión posteriores
La caché de sesiones se crea y gestiona automáticamente
Usa MONARCH_FORCE_LOGIN=true en la sección env para forzar un inicio de sesión nuevo si es necesario

Solución de problemas

Problemas de MFA

Asegúrate de que tu secreto MFA sea correcto y esté formateado correctamente
Intenta configurar MONARCH_FORCE_LOGIN=true en tu sección env de .mcp.json
Comprueba que la hora de tu sistema sea precisa (requerido para TOTP)

Problemas de conexión

Verifica que tu correo electrónico y contraseña sean correctos en .mcp.json
Comprueba tu conexión a internet
Intenta ejecutar el servidor directamente para ver mensajes de error detallados:
```
uv run server.py
```

Problemas de sesión

Elimina el directorio .mm para borrar las sesiones en caché
Configura MONARCH_FORCE_LOGIN=true en tu sección env de .mcp.json temporalmente

Créditos

Servidor MCP

Autor: Taurus Colvin (@colvint)
Descripción: Envoltorio de servidor MCP (Model Context Protocol) para Monarch Money

Biblioteca Python MonarchMoney

Autor: hammem (@hammem)
Repositorio: https://github.com/hammem/monarchmoney
Licencia: Licencia MIT
Descripción: La biblioteca Python subyacente que proporciona acceso API a Monarch Money

Este servidor MCP envuelve la biblioteca Python monarchmoney para proporcionar una integración perfecta con asistentes de IA a través del Model Context Protocol.

Notas de seguridad

Mantén tus credenciales seguras en tu archivo .mcp.json
El secreto MFA proporciona acceso completo a tu cuenta: trátalo como una contraseña
Los archivos de sesión en el directorio .mm contienen tokens de autenticación: mantenlos seguros
Considera restringir el acceso a tu archivo .mcp.json ya que contiene credenciales sensibles