Vikunja MCP Server
vikunja-mcp
Un servidor MCP (Model Context Protocol) remoto que conecta Claude a tu instancia de Vikunja autohospedada. Añádelo como un conector personalizado en Claude.ai y gestiona tus tareas de forma conversacional.
Herramientas disponibles
Herramienta | Descripción |
| Listar todos los proyectos |
| Obtener detalles del proyecto |
| Crear un nuevo proyecto |
| Actualizar un proyecto |
| Eliminar un proyecto |
| Listar/filtrar/buscar tareas en todos los proyectos |
| Obtener detalles de la tarea, incluidos los comentarios |
| Crear una tarea en un proyecto |
| Actualizar las propiedades de una tarea |
| Eliminar una tarea |
| Marcar una tarea como completada |
| Marcar una tarea como no completada |
| Añadir un comentario a una tarea |
| Listar todas las etiquetas |
| Crear una nueva etiqueta |
| Adjuntar una etiqueta a una tarea |
| Eliminar una etiqueta de una tarea |
| Generar un resumen de revisión semanal |
| Vista de agenda de tareas con fechas de vencimiento (vencidas + próximas) |
| Vincular dos tareas (subtarea, bloqueo, precede, relacionado, …) |
| Eliminar una relación entre dos tareas |
Related MCP server: vikunja-mcp
Inicio rápido
npm install
npm run build
export VIKUNJA_URL=https://your-vikunja-instance.example.com
export VIKUNJA_TOKEN=your-api-token
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
export PORT=9090
node build/index.jsLuego, añade tu servidor como un conector personalizado en Claude.ai en Ajustes > Conectores:
https://your-server.example.com/mcp?token=<MCP_AUTH_TOKEN>Consulta DEPLOY-UBERSPACE.md para ver una guía completa de despliegue en Uberspace.
Configuración
Variable | Requerido | Descripción |
| Sí | URL base de tu instancia de Vikunja (sin barra diagonal al final) |
| Sí | Token de API desde Ajustes de Vikunja > Tokens de API |
| Recomendado | Secreto compartido para el endpoint |
| No | Puerto en el que escuchar (por defecto: |
Autenticación
Cuando se establece MCP_AUTH_TOKEN, el servidor rechaza cualquier solicitud a /mcp que no incluya un parámetro de consulta ?token=… coincidente con una respuesta 401 Unauthorized.
Genera un token seguro:
openssl rand -hex 32Añádelo a la URL del conector en Claude.ai:
https://your-server.example.com/mcp?token=<your-token>Si MCP_AUTH_TOKEN se deja sin establecer, el endpoint estará abierto a cualquiera que pueda acceder a él; haz esto solo en una red privada y protegida por firewall.
Feed de calendario
El servidor expone un feed iCal legible por máquina al que puedes suscribirte en cualquier aplicación de calendario:
webcal://your-server.example.com/calendar.icsIncluye todas las tareas abiertas y las tareas completadas en los últimos 30 días que tengan una fecha de inicio, fecha de vencimiento o fecha de finalización. Suscríbete una vez y tu aplicación de calendario lo consultará automáticamente.
Arquitectura
Transporte: HTTP transmitible (sin estado) — el estándar MCP actual para servidores remotos
Autenticación: Token de parámetro de consulta (
MCP_AUTH_TOKEN) para el endpoint MCP; token de API de Vikunja para llamadas a la API ascendenteRuntime: Node.js + Express
SDK:
@modelcontextprotocol/sdkv1.x
Requisitos
Node.js ≥ 18
Una instancia de Vikunja autohospedada con un token de API
Una URL accesible públicamente para que Claude.ai pueda llegar al servidor
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
- platform7nOAuthtech.p7n
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Personal CRM for Claude. Contacts live as plain-text files in your own Google Drive.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Vikunja task management instances through natural language. Supports comprehensive project and task operations including CRUD, assignments, labels, comments, relations, and attachments.3344 npm2MIT
- AlicenseCqualityCmaintenanceEnables AI assistants to interact with Vikunja task management via ergonomic and raw REST tools for projects, tasks, labels, and comments.10010 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables to interact with Vikunja task management through its REST API, supporting projects, tasks, comments, labels, assignees, and relations with field preservation.44 npmMIT
- AlicenseCqualityDmaintenanceEnables AI assistants to interact with Vikunja task management instances, providing full task, project, label, and user management capabilities.17141 npmMIT