YNAB MCP

Servidor de protocolo de contexto de modelo (MCP) de YNAB para la integración de Claude Code con You Need A Budget (YNAB).

Descripción general

Este repositorio contiene un servidor MCP basado en Docker que permite a Claude Code interactuar con las cuentas de YNAB (You Need A Budget). Implementa el flujo OAuth y proporciona una API completa para la gestión de presupuestos, el seguimiento de transacciones y la información financiera.

Características

• Autenticación basada en OAuth con API de YNAB

• Gestión completa de presupuestos y cuentas

• Creación y categorización de transacciones

• Soporte para múltiples presupuestos (personales y familiares)

• Manejo de límite de velocidad (límite de API de YNAB: 200 solicitudes/hora)

• Almacenamiento en caché para un mejor rendimiento

Empezando

Prerrequisitos

• Estibador

• Node.js v18+ (para desarrollo)

• CLI de Claude Code

• Cuenta de YNAB

Instalación

1. Clonar este repositorio

2. Copie config/config.example.js a config/config.js y agregue sus credenciales de API de YNAB

3. Construya la imagen de Docker: docker build -t ynab-mcp:latest .

4. Crea una configuración JSON para Claude:

   { "command": "docker", "args": [ "run", "--rm", "-i", "-v", "/path/to/data:/app/data", "-v", "/path/to/config:/app/config", "-e", "NODE_ENV=production", "ynab-mcp:latest" ] }

5. Registre el MCP con Claude Code CLI:

   claude mcp add-json ynab '{"command": "docker", "args": ["run", "--rm", "-i", "-v", "/path/to/data:/app/data", "-v", "/path/to/config:/app/config", "-e", "NODE_ENV=production", "ynab-mcp:latest"]}'

   También puedes guardar el JSON en un archivo y usar:

   claude mcp add-json ynab "$(cat config.json)"

6. Autentíquese con su cuenta de YNAB cuando Claude se lo solicite

Integración con Claude

Este MCP se integra perfectamente con Claude, lo que permite:

• Visualización de presupuestos y transacciones

• Obtener información financiera

• Gestionar tu presupuesto a través de la conversación natural

Seguridad

• Los tokens se almacenan de forma segura en un volumen Docker montado

• No se registran datos confidenciales

• La autenticación utiliza los estándares OAuth 2.0

• Soporte para modo de solo lectura

Detalles de implementación

La implementación sigue el estándar del Protocolo de Contexto de Modelo utilizando:

• Node.js y el SDK oficial de MCP

• Docker para contenerización e implementación

• SDK de JavaScript de YNAB para operaciones API

• OAuth 2.0 para autenticación

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud

• API de YNAB

• Biblioteca de JavaScript de YNAB

• Claude antrópico