monzo-mcp

Servidor MCP para la API bancaria de Monzo. Acceso de solo lectura a cuentas, saldos, huchas, transacciones y análisis de gastos, todo a través de Claude Code o cualquier cliente MCP.

A diferencia de otras implementaciones de Monzo MCP que utilizan tokens de portador (bearer tokens) sin procesar (que caducan en 6 horas), este servidor gestiona OAuth completo con actualización automática de tokens.

Características

• 7 herramientas de solo lectura - sin operaciones de escritura, sin movimiento de dinero

• OAuth con actualización automática - los tokens se actualizan automáticamente, sin necesidad de regeneración manual

• Caché local de transacciones - la base de datos SQLite sobrevive a la ventana de SCA de 90 días de Monzo

• Análisis de gastos - desglose por categorías, principales comercios, comparación mes a mes

• Búsqueda de transacciones - búsqueda por comercio, descripción o notas en el historial almacenado en caché

Related MCP server: monzo-mcp

Herramientas

Requisitos previos

• Python 3.13+

• uv (recomendado) o pip

• Una cuenta de Monzo con un cliente OAuth registrado en developers.monzo.com

Instalación

git clone https://github.com/partymola/monzo-mcp.git
cd monzo-mcp
uv venv --python 3.13 .venv
uv pip install -e .

Configuración

1. Registrar un cliente OAuth de Monzo

Ve a developers.monzo.com y crea un cliente OAuth:

• Establece la URL de redirección en http://localhost:6600/callback

• Anota tu Client ID y Client Secret

2. Autenticación

monzo-mcp auth

Esto abrirá tu navegador para el OAuth de Monzo. Después de autorizar, aprueba el inicio de sesión en tu aplicación Monzo en un plazo de 5 minutos para obtener acceso al historial completo de transacciones (ventana SCA de Monzo).

3. Registrar con Claude Code

claude mcp add -s user monzo -- /path/to/monzo-mcp/.venv/bin/monzo-mcp

4. Primera sincronización

En Claude Code, ejecuta monzo_sync para completar la caché local de transacciones. Haz esto inmediatamente después de la autenticación para aprovechar la ventana SCA (hasta 11 meses de historial).

Configuración

Toda la configuración se realiza mediante variables de entorno (opcional):

Archivos de credenciales (creados por monzo-mcp auth):

• config/monzo_client.json - ID y secreto del cliente OAuth

• config/monzo_tokens.json - Tokens de acceso y actualización (actualizados automáticamente)

Ventana SCA de Monzo

La Autenticación Reforzada de Cliente (SCA) de Monzo limita el acceso al historial de transacciones:

• Dentro de los 5 minutos posteriores a la aprobación en la aplicación: hasta ~11 meses de historial

• Después de que expire la ventana: solo los últimos 90 días

La caché local de SQLite conserva todas las transacciones sincronizadas de forma permanente, así que ejecuta monzo_sync rápidamente después de monzo-mcp auth.

Seguridad

• Cero herramientas de escritura - no puede enviar dinero, mover fondos entre huchas ni modificar transacciones

• La propia API de Monzo no puede enviar dinero a cuentas externas

• Los tokens se almacenan como archivos JSON en el directorio config/ (ignorado por git)

• Todas las llamadas a la API son solicitudes GET con autenticación de token Bearer

Contribución

Consulta CONTRIBUTING.md para la configuración del desarrollo, el flujo de trabajo de pruebas y el hook de pre-commit. Los cambios se rastrean en CHANGELOG.md.

Licencia

GPL-3.0-or-later. Consulta LICENSE.