openbanking-mcp
Allows querying accounts, balances, and transactions from CaixaBank via TrueLayer PSD2 API, and generates analytics such as spending by category, subscriptions, unusual charges, and monthly summaries.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@openbanking-mcp show my last 10 transactions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
openbanking-mcp
Servidor MCP de finanzas personales de solo lectura sobre Open Banking (PSD2), vía Enable Banking. Consulta cuentas, saldos y movimientos de tu banco y genera analítica: gasto por categoría, suscripciones, cargos inusuales y resúmenes mensuales — desde Claude Desktop, Cursor o ChatGPT.
Solo lectura. No inicia pagos ni transferencias: solo se piden permisos de datos (cuentas, saldos y movimientos).
Funciona con casi toda la banca europea (CaixaBank incluido). El banco se elige con
ENABLEBANKING_ASPSP_NAMEen tu.env.
Aviso
Proyecto independiente, no afiliado ni respaldado por Enable Banking ni por ningún banco.
Manejas tus propios datos bancarios bajo tu responsabilidad: cada quien autohospeda
con sus credenciales y los datos nunca salen de tu máquina (SQLite local; tokens y
clave privada cifrados/protegidos en data/, que está en .gitignore). Software
entregado "tal cual", sin garantías (ver LICENSE). Lee las notas PSD2.
Related MCP server: open-banking-mcp
Arquitectura
Tu banco (PSD2)
-> Enable Banking (AIS) [interfaz BankDataProvider]
-> Capa de sincronización (pull idempotente e incremental)
-> SQLite (SQLAlchemy)
-> Capa de analítica (funciones puras)
-> Servidor MCP (solo lectura)
-> Cliente MCP: Claude Desktop / Cursor / ChatGPTEl servidor MCP lee de SQLite, nunca llama al banco en caliente. La sincronización
es un proceso aparte (finmcp sync, manual o por cron).
¿Por qué Enable Banking? Es el agregador AIS self-serve y gratis para uso personal que cubre la banca europea. (GoCardless/Nordigen cerró nuevos registros y la Data API de TrueLayer ya no se concede self-serve.) El código mantiene una interfaz
BankDataProvider, así que añadir otro proveedor es sencillo.
Paso a paso
1. Instala el proyecto
git clone https://github.com/guille-near/openbanking-mcp.git && cd openbanking-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"2. Registra tu app en Enable Banking
Entra en enablebanking.com → Control Panel y regístrate.
Crea una aplicación:
Generación de clave: "Generate in the browser… export private key".
Allowed redirect URLs:
https://localhost:3000/callback(exige HTTPS).Rellena nombre, email y (si los pide) URLs de privacidad/términos.
Al registrar, descarga la clave privada (
.pem) — solo se muestra una vez — y copia el Application ID (es el nombre del fichero.pem).Restricted Production: en la app, pulsa Link accounts y vincula (lista blanca) las cuentas de tu banco que quieras leer. En modo Restricted solo se pueden acceder esas cuentas (no requiere due diligence; perfecto para uso personal).
3. Configura el .env
cp .env.example .envGuarda la clave privada en data/enablebanking_private.pem y edita el .env:
FINMCP_PROVIDER=enablebanking
ENABLEBANKING_APP_ID=<tu Application ID>
ENABLEBANKING_COUNTRY=ES
# ENABLEBANKING_KEY_PATH=/ruta/a/clave.pem # solo si NO usas data/enablebanking_private.pem4. Elige tu banco
finmcp institutions # lista las entidades (p.ej. "CaixaBank · ES")Fija el nombre exacto en el .env:
ENABLEBANKING_ASPSP_NAME=CaixaBank5. Autoriza y sincroniza
finmcp auth # abre tu banco para el SCA
finmcp sync # baja cuentas/saldos/movimientos a SQLite
finmcp accounts # comprobaciónEn finmcp auth, tras el SCA el navegador irá a https://localhost:3000/callback y
mostrará un error de conexión: es normal. Copia el valor de code de la barra de
direcciones (o pega la URL entera) cuando el CLI lo pida. El código nunca sale de tu máquina.
El consentimiento dura ~90 días (límite PSD2); pasado ese plazo, repite
finmcp auth.
Comandos
Comando | Descripción |
| Autoriza con tu banco y guarda la sesión cifrada |
| Lista las entidades disponibles (para fijar |
| Trae cuentas/saldos/movimientos a SQLite |
| Lista las cuentas locales |
| Importa movimientos desde un CSV (histórico anterior a 90 días) |
| Reaplica tus reglas de categorización |
| Gestiona reglas de categorización |
| Arranca el servidor MCP (stdio; |
Herramientas MCP (solo lectura)
list_accounts · get_balances · get_transactions · search_transactions ·
spend_by_category_tool · list_subscriptions · unusual_charges ·
monthly_summary_tool · sync_status
Cargos inusuales usa mediana + MAD (robusto): un único pico no contamina su propia línea base, así que se detecta de verdad.
Conectar a Claude Desktop
En claude_desktop_config.json (usa la ruta absoluta a tu clon del repo):
{
"mcpServers": {
"openbanking": {
"command": "/RUTA/ABSOLUTA/A/openbanking-mcp/.venv/bin/finmcp",
"args": ["serve"]
}
}
}El servidor lee de SQLite; recuerda correr finmcp sync (manual o por cron) para
mantener los datos al día.
Conectar a ChatGPT
ChatGPT solo se conecta a servidores MCP remotos por HTTP(S). Hay que exponer el servidor por una URL pública y añadirlo como connector en Modo Desarrollador.
⚠️ Datos bancarios por una URL pública. Usa SIEMPRE bearer token y HTTPS. Para uso solo-local, Claude Desktop (stdio) es más seguro.
export FINMCP_HTTP_TOKEN="<token-largo-aleatorio>"
finmcp serve --http --port 8000 # expone POST /mcp (401 sin el token)
ngrok http 8000 # túnel HTTPS -> https://xxxx.ngrok.appEn ChatGPT → Connectors → Add custom connector: URL https://xxxx.ngrok.app/mcp,
cabecera Authorization: Bearer <FINMCP_HTTP_TOKEN>.
Categorías personalizadas
Enable Banking no envía categoría en los movimientos, así que las defines tú con reglas:
finmcp rules add "mercadona" "Supermercado"
finmcp rules add "vodafone" "Telefonía" --field merchant
finmcp rules list
finmcp categorize # reaplica todas las reglasLas reglas se reaplican automáticamente al final de cada finmcp sync.
my_category (manual/regla) tiene prioridad sobre cualquier categoría del proveedor.
Importar histórico antiguo (CSV)
Las APIs PSD2 solo dan ~90 días de histórico. Para movimientos más antiguos,
exporta tus movimientos desde la web de tu banco (Excel .xlsx o CSV/TXT) e impórtalos:
finmcp import-csv movimientos.xlsx --iban ES58... # o un .csv / .txtAcepta Excel (.xlsx y .xls) y texto (CSV/TXT); detecta el delimitador, las
cabeceras y el formato español de fecha/importe. Soporta importe en una columna con
signo o en columnas Ingreso/Gasto separadas (formato CaixaBank), y si el fichero
trae varias cuentas (columna Número de cuenta) mapea cada movimiento a su cuenta.
Deduplica por (cuenta, día, importe, tipo), así que es seguro reimportar o
solapar con lo que ya bajó la API. Las reglas de categorización se aplican solas.
Sincronización programada (macOS / launchd)
# Sustituye __PROJECT_DIR__ por la ruta absoluta de tu clon
sed -i '' "s|__PROJECT_DIR__|$PWD|g" deploy/com.openbanking-mcp.sync.plist
# Copia el LaunchAgent y actívalo (sync cada 6 h)
cp deploy/com.openbanking-mcp.sync.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.openbanking-mcp.sync.plist
# Logs en data/sync.log · para parar:
launchctl unload ~/Library/LaunchAgents/com.openbanking-mcp.sync.plistNotas PSD2
El consentimiento PSD2 caduca: hay que re-autorizar con SCA cada ~90 días (
finmcp auth).En Restricted Production solo se leen las cuentas que hayas vinculado (lista blanca) en el panel de Enable Banking.
El histórico disponible suele limitarse a ~90 días por las APIs PSD2 de los bancos.
Desarrollo
pip install -e ".[dev]"
pytest # suite de tests (analítica, mapper, sync, config)La analítica son funciones puras testeadas contra una SQLite en memoria; el flujo de
sync se prueba con un cliente falso (sin tocar el banco). CI en GitHub Actions corre la
suite en Python 3.11–3.13 (.github/workflows/ci.yml).
Licencia
MIT © 2026 Guille Pérez
Available Tools
9 toolsget_balancesA
Saldo más reciente de cada cuenta.
Inputs: no named parameters. Returns: result
get_transactionsB
Movimientos filtrados por cuenta, fechas (YYYY-MM-DD) y tipo (debit/credit).
Inputs: end, type, limit, start, +1 more. Returns: result
list_accountsB
Lista las cuentas bancarias sincronizadas.
Inputs: no named parameters. Returns: result
list_subscriptionsC
Cargos recurrentes detectados (suscripciones / domiciliaciones).
Inputs: lookback_months. Returns: result
monthly_summary_toolC
Resumen mensual: ingresos, gastos, neto, top comercios y categorías.
Inputs: year (required), month (required).
search_transactionsA
Busca movimientos por texto en el comercio o el concepto.
Inputs: query (required), limit. Returns: result
spend_by_category_toolB
Gasto agregado por categoría en un periodo (fechas YYYY-MM-DD).
Inputs: end, start. Returns: result
sync_statusB
Estado de la última sincronización.
Inputs: no named parameters.
unusual_chargesC
Cargos atípicos respecto al histórico de cada comercio.
Inputs: end, start. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct function: account listing, balances, filtered transactions, subscriptions, monthly summary, text search, category spending, sync status, and unusual charges. There is no functional overlap.
Most tools follow a verb_noun pattern in snake_case (e.g., get_balances, list_accounts). However, monthly_summary_tool and spend_by_category_tool include a '_tool' suffix not used by others, causing minor inconsistency.
9 tools is appropriate for the domain. Each tool provides a specific capability without redundancy, covering account management, transaction analysis, subscriptions, and sync status.
The set covers core read-only banking operations: accounts, balances, transactions, subscriptions, and spending analysis. Missing is the ability to retrieve a single transaction detail, but overall it is reasonably complete for an analytics-focused MCP.
Maintenance
Related MCP Connectors
Read-only access to your own UK bank data: spending, subscriptions, payday plan, net worth.
Read-only access to your bank, investment, and crypto accounts: balances, transactions, holdings.
Read-only access to your Finch finances: accounts, transactions, spending, net worth, goals.
Read-only cash flow, spending, subscriptions and transaction search from your US and Canadian banks.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables interaction with bank accounts via TrueLayer API, supporting listing accounts and retrieving transactions.91MIT
- AlicenseBqualityBmaintenanceEnables Claude to read UK bank account data—balances, transactions, cards, standing orders, direct debits, and identity—through TrueLayer's Data API, with local caching and optional live refreshes. It is read-only by design, requiring consent and never moving money.121MIT
- AlicenseNot gradedqualityCmaintenanceEnables read-only access to personal European bank accounts through Enable Banking, allowing MCP clients to list accounts, retrieve balances, search and summarize transactions, and estimate spending with bounded, privacy-preserving tools.MIT
- AlicenseNot gradedqualityCmaintenanceEnables read-only access to Brazilian Open Finance banking data through Pluggy, allowing queries of accounts, balances, transactions, card bills, category spending, and connection status.MIT