Servidor MCP de Monarch Money

Un servidor del Protocolo de Contexto de Modelos (MCP) para integrarse con la plataforma de finanzas personales Monarch Money a través de Claude Desktop.

Descripción general

• Seguro por diseño — inicio de sesión basado en navegador, token almacenado en el llavero del sistema operativo (nunca en archivos de configuración o variables de entorno)

• Seguro por defecto — el modo de solo lectura evita cambios accidentales; las herramientas de escritura requieren una activación explícita

• Completo — 37 herramientas que cubren cuentas, transacciones, divisiones, presupuestos, flujo de caja, etiquetas, categorías e historial crediticio

• Fácil de instalar — extensión de Claude Desktop (.mcpb), uvx o pip

Dos modos de funcionamiento:

El servidor se inicia en modo de solo lectura por defecto. Las herramientas de escritura están ocultas y bloqueadas hasta que usted las active explícitamente.

Related MCP server: Monarch Money MCP Server

Inicio rápido

Instalación

Opción 1: Extensión de Claude Desktop (.mcpb) — Recomendado para Claude Desktop

Permite activar/desactivar el modo de escritura directamente desde la aplicación Claude Desktop.

1. Descargue el .mcpb más reciente desde Releases

2. En Claude Desktop: Settings > Extensions > Advanced Settings > Install Extensions — seleccione el archivo .mcpb

3. Reinicie Claude Desktop

Para habilitar las herramientas de escritura: Settings > Extensions > Monarch Money MCP Server > Configure — active "Enable write tools" y haga clic en Save.

Opción 2: uvx (no requiere instalación) — Recomendado para agentes (ej. Claude Code o Cursor)

También funciona con Claude Desktop, pero el modo de escritura no se puede activar desde la aplicación; configúrelo en el archivo de configuración.

Añada esto a su archivo de configuración de MCP:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp"]
    }
  }
}

Para habilitar las herramientas de escritura:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp", "--enable-write"]
    }
  }
}

Opción 3: Instalación mediante pip — Recomendado para instalación local y venv

pip install monarch-mcp

Colaboradores: Consulte docs/releasing.md para conocer el proceso de lanzamiento, el esquema de versiones y las pruebas previas al lanzamiento a través de TestPyPI.

Añada esto a su configuración de MCP usando la ruta completa a su intérprete de Python:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

Para habilitar las herramientas de escritura, añada "--enable-write" a args.

Opción 4: Clonar e instalar — Recomendado para desarrollo

git clone https://github.com/vargahis/monarch-mcp.git
cd monarch-mcp
pip install -e .

Luego añada esto a su configuración de MCP usando el intérprete de Python de su entorno de desarrollo:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

Para habilitar las herramientas de escritura, añada "--enable-write" a args.

Autenticación

La autenticación ocurre automáticamente en su navegador la primera vez que el servidor MCP se inicia sin una sesión guardada.

1. Inicie (o reinicie) Claude Desktop

2. El servidor detecta que no existe ningún token y abre una página de inicio de sesión en su navegador

3. Introduzca su correo electrónico y contraseña de Monarch Money

4. Proporcione su código 2FA si tiene habilitada la MFA

5. Una vez autenticado, el token se guarda en el llavero de su sistema; ya está todo listo

Detalles clave:

• Las credenciales se introducen solo en su navegador — nunca a través de Claude Desktop

• Token almacenado en el llavero del sistema operativo — persiste tras los reinicios, dura semanas/meses

• Las sesiones caducadas se reautentican automáticamente — el inicio de sesión en el navegador se vuelve a activar en la siguiente llamada a la herramienta

• MFA totalmente compatible

• Alternativa: ejecute python login_setup.py en una terminal para entornos sin interfaz gráfica (headless)

Para obtener detalles técnicos sobre la arquitectura de autenticación, consulte docs/authentication.md.

Ejemplos de uso

Show me all my financial accounts

What were my last 50 transactions?

How's my budget looking this month?

Analyze my cashflow for the last 3 months

Create a tag called "Business Expenses" in red

Herramientas disponibles

🙏 Agradecimientos

Derivado de monarch-mcp-server de @robcerda, mantenido por vargahis.

Construido sobre la biblioteca de Python monarchmoneycommunity.

Gracias a:

• @robcerda por el servidor MCP original

• @hammem por la biblioteca original monarchmoney

• @bradleyseanf por la bifurcación de la comunidad

Licencia

Licencia MIT