ClickUp MCP (HTTP transmitible)

Servidor MCP para la API REST de ClickUp con:

• Búsqueda de tareas en todo el espacio de trabajo (GET /team/{team_id}/task)

• CRUD de tareas (+ subtareas)

• Navegación básica (equipos, espacios, carpetas, listas)

• Ayudantes de actividad reciente (mediante date_updated_gt, además de registros de auditoría cuando estén disponibles)

• CRUD/búsqueda de documentos (API v3): buscar, obtener, crear documentos y páginas

• Vía de escape: herramienta genérica para llamar a cualquier endpoint de la API de ClickUp (v2 y v3).

Este servidor está diseñado para ejecutarse como un servicio Docker y ser consumido por OpenWebUI y LibreChat.

Entorno

• CLICKUP_API_TOKEN (obligatorio)

• CLICKUP_TEAM_ID (opcional, detectará automáticamente el primer equipo si no se establece)

• CLICKUP_WORKSPACE_ID (opcional; ClickUp a menudo llama a esto "team_id" en la v2)

• CLICKUP_API_BASE_URL (opcional, predeterminado https://api.clickup.com/api/v2)

• CLICKUP_API_V3_BASE_URL (opcional, predeterminado https://api.clickup.com/api/v3)

Ejecución (local)

python -m clickup_mcp --transport streamable-http --host 0.0.0.0 --port 8000 --path /mcp

OpenWebUI debería conectarse a: http://clickup-mcp:8000/mcp

Herramientas

Tareas (API v2)

• search_tasks - Buscar tareas por nombre/descripción

• filter_tasks - Filtrar tareas por metadatos (estado, asignado, fechas, etc.)

• get_task - Obtener una tarea por ID

• create_task - Crear una nueva tarea

• create_subtask - Crear una subtarea bajo una tarea existente

• update_task - Actualizar una tarea

• delete_task - Eliminar una tarea

• get_task_comments - Obtener comentarios de una tarea

• create_task_comment - Crear un comentario en una tarea

Navegación (API v2)

• clickup_context - Obtener contexto resuelto (ID de equipo/espacio de trabajo y usuario actual)

• list_teams - Listar equipos/espacios de trabajo de ClickUp

• get_team - Obtener un equipo por ID

• list_spaces - Listar espacios en un equipo

• list_folders - Listar carpetas en un espacio

• list_lists_in_space - Listar listas (sin carpeta) en un espacio

• list_lists_in_folder - Listar listas en una carpeta

• list_tasks_in_list - Listar tareas en una lista

Documentos (API v3)

• search_docs - Buscar/listar todos los documentos en el espacio de trabajo

• get_doc - Obtener un documento por ID (incluye lista de páginas)

• create_doc - Crear un nuevo documento

Páginas (API v3)

• list_doc_pages - Listar todas las páginas en un documento

• get_doc_page_listing - Obtener la estructura jerárquica de páginas para un documento

• get_doc_page - Obtener una página específica (con contenido)

• create_doc_page - Crear una nueva página en un documento

• update_doc_page - Actualizar/editar una página (reemplazar, añadir al final o al principio el contenido)

Utilidad

• recent_activity - Obtener actividad reciente (registros de auditoría o tareas actualizadas recientemente)

• clickup_api_request - Vía de escape genérica para la API v2

• clickup_v3_api_request - Vía de escape genérica para la API v3

• health - Comprobación de estado