Skip to main content
Glama
lindenlion

Vikunja MCP Server

by lindenlion

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

list_projects

Listar todos los proyectos

get_project

Obtener detalles del proyecto

create_project

Crear un nuevo proyecto

update_project

Actualizar un proyecto

delete_project

Eliminar un proyecto

list_tasks

Listar/filtrar/buscar tareas en todos los proyectos

get_task

Obtener detalles de la tarea, incluidos los comentarios

create_task

Crear una tarea en un proyecto

update_task

Actualizar las propiedades de una tarea

delete_task

Eliminar una tarea

complete_task

Marcar una tarea como completada

reopen_task

Marcar una tarea como no completada

add_comment

Añadir un comentario a una tarea

list_labels

Listar todas las etiquetas

create_label

Crear una nueva etiqueta

add_label_to_task

Adjuntar una etiqueta a una tarea

remove_label_from_task

Eliminar una etiqueta de una tarea

weekly_review

Generar un resumen de revisión semanal

get_calendar

Vista de agenda de tareas con fechas de vencimiento (vencidas + próximas)

create_relation

Vincular dos tareas (subtarea, bloqueo, precede, relacionado, …)

remove_relation

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.js

Luego, 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

VIKUNJA_URL

Sí

URL base de tu instancia de Vikunja (sin barra diagonal al final)

VIKUNJA_TOKEN

Sí

Token de API desde Ajustes de Vikunja > Tokens de API

MCP_AUTH_TOKEN

Recomendado

Secreto compartido para el endpoint /mcp — ver Auth

PORT

No

Puerto en el que escuchar (por defecto: 3000)

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 32

Añá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.ics

Incluye 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 ascendente

  • Runtime: Node.js + Express

  • SDK: @modelcontextprotocol/sdk v1.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

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers