YNAB

Servidor MCP de YNAB

Un servidor de Model Context Protocol (MCP) para interactuar con YNAB (You Need A Budget). Proporciona herramientas para acceder a datos de presupuestos a través de clientes compatibles con MCP, como Claude Desktop.

Configuración del Cliente MCP

Configuración Básica

Añade esto a la configuración de tu 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 estás ejecutando 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 MCP Inspector:

1. Instala el inspector:

npm install -g @modelcontextprotocol/inspector

2. Actualiza tu configuración para usar 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 a herramientas y respuestas
• Inspección de solicitudes/respuestas
• Validación de esquemas de herramientas
• Interfaz de pruebas interactiva

Herramientas Disponibles

GetUser

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

ListBudgets

Lista todos los presupuestos accesibles para el usuario autenticado, incluidos los IDs y nombres de los presupuestos.

GetBudget

Recupera información detallada sobre un presupuesto específico, incluidas transacciones, categorías y saldos. Admite filtrado opcional por fecha y límite de transacciones.

Nota: Los montos monetarios se devuelven en miliunidades (por ejemplo, 1000 = $1.00)

GetBudgetCategories

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

GetBudgetSettings

Recupera la configuración del presupuesto especificado, incluidos el formato de moneda, el formato de fecha y otras preferencias.