ynab-mcp

Servidor MCP de YNAB

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con YNAB (You Need A Budget). Proporciona herramientas para acceder a datos presupuestarios mediante clientes compatibles con MCP, como Claude Desktop.

Configuración del cliente MCP

Configuración básica

Agregue esto a la configuración de su cliente MCP (por ejemplo, cline_mcp_settings.json para Claude Desktop):

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["run", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuración avanzada

Si se ejecuta desde un directorio específico:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Depuración

Para depurar con el Inspector MCP:

Instalar el inspector:

npm install -g @modelcontextprotocol/inspector

Actualice su configuración para utilizar el inspector con uv:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "@modelcontextprotocol/inspector", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

El inspector proporciona:

Registros en tiempo real de llamadas y respuestas de herramientas
Inspección de solicitud/respuesta
Validación del esquema de herramientas
Interfaz de prueba interactiva

Herramientas disponibles

Obtener usuario

Recupera información sobre el usuario autenticado de YNAB, incluido el ID de usuario y el correo electrónico.

Lista de presupuestos

Enumera todos los presupuestos accesibles para el usuario autenticado, incluidos los nombres e identificadores de los presupuestos.

Obtener presupuesto

Recupera información detallada sobre un presupuesto específico, incluyendo transacciones, categorías y saldos. Admite filtrado por fecha y limitación de transacciones opcionales.

Nota: Los importes monetarios se devuelven en miliunidades (por ejemplo, 1000 = $1,00)

Obtener categorías de presupuesto

Recupera todas las categorías definidas en el presupuesto especificado, incluidos grupos de categorías, nombres e identificaciones.

Obtener ajustes de presupuesto

Recupera configuraciones para el presupuesto especificado, incluido el formato de moneda, el formato de fecha y otras preferencias.