YNAB MCP

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