clickup-mcp

Servidor MCP de ClickUp ligero centrado en la gestión de tareas. 39 herramientas con respuestas optimizadas para tokens: las respuestas de la API se reducen automáticamente de miles de caracteres a lo esencial.

¿Por qué este servidor?

La API de ClickUp devuelve un JSON extremadamente verboso. Este servidor lo reduce:

Menos tokens = respuestas más rápidas, menores costes y más contexto para tu IA.

Related MCP server: ClickUp MCP Server

Instalación

npm install -g @cavort-it-systems/clickup-mcp

O ejecuta directamente:

npx @cavort-it-systems/clickup-mcp

Configuración

Claude Code CLI

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp

Claude Desktop / Manual

Añádelo a tu configuración de MCP (~/.claude.json o los ajustes de Claude Desktop):

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@cavort-it-systems/clickup-mcp"],
      "env": {
        "CLICKUP_API_TOKEN": "your-token"
      }
    }
  }
}

Desde el código fuente

git clone https://github.com/cvrt-jh/clickup-mcp.git
cd clickup-mcp
npm install && npm run build

Luego configúralo con la ruta compilada:

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- node /path/to/clickup-mcp/build/index.js

Obtén tu token de API

1. Ve a Configuración de ClickUp > Aplicaciones

2. Genera un token de API personal

3. Configúralo como CLICKUP_API_TOKEN

Reducción de respuestas

Todas las respuestas se recortan automáticamente para ahorrar tokens. La API de ClickUp devuelve un JSON extremadamente verboso; este servidor lo reduce a lo que importa.

clickup_whoami - de ~3.500 caracteres a ~160:

// Before (ClickUp API raw)
{"user":{"id":12345678,"username":"Jane Doe","email":"jane@example.com","color":"#0388d1",
"profilePicture":"https://attachments.clickup.com/...","initials":"JD",
"week_start_day":1,"global_font_support":true,"timezone":"Europe/Berlin"},
"teams":{"teams":[{"id":"99999999","name":"My Workspace","color":"#40BC86",
"avatar":"https://attachments2.clickup.com/...?Expires=...&Key-Pair-Id=...&Signature=...",
"members":[{"user":{"id":11111111,"username":"Bob Smith","email":"bob@example.com",
"color":"#aa2fff","profilePicture":null,"initials":"BS","role":4,"role_subtype":2,
"role_key":"guest","custom_role":null,"last_active":"...","date_joined":"...",
"date_invited":"..."},"invited_by":{"id":22222222,...},
"can_see_time_spent":true,...}, ...]}]}}

// After (slimmed)
{"id":12345678,"username":"Jane Doe","email":"jane@example.com",
"timezone":"Europe/Berlin","workspaces":[{"id":"99999999",
"name":"My Workspace","member_count":4}]}

clickup_create_comment - de ~1.500 caracteres a 38:

// Before
{"id":90150191300876,"hist_id":"...","date":1770053982842,
"version":{"object_type":"comment","object_id":"...","workspace_id":99999999,
"operation":"c","data":{"context":{"root_parent_type":1,"is_chat":false,
"audit_context":{"userid":12345678,"current_time":...,"route":"*"},...},...},...}}

// After
{"id":90150191300876,"date":1770053982842}

Qué se elimina:

Herramientas (37)

Navegación (7)

• clickup_whoami - Usuario actual + espacios de trabajo

• clickup_get_spaces - Espacios en el espacio de trabajo

• clickup_get_folders - Carpetas en el espacio

• clickup_get_lists - Listas en la carpeta o el espacio

• clickup_get_list - Detalles de una sola lista

• clickup_create_list - Crear lista en la carpeta o el espacio

• clickup_delete_list - Eliminar una lista (permanente)

CRUD de tareas (5)

• clickup_get_task - Obtener tarea por ID

• clickup_create_task - Crear tarea con todos los campos

• clickup_update_task - Actualizar cualquier campo de la tarea

• clickup_get_tasks - Listar tareas en una lista

• clickup_search_tasks - Buscar tareas en todo el espacio de trabajo

Campos personalizados (1)

• clickup_set_custom_field - Establecer valor de campo personalizado

Etiquetas (6)

• clickup_get_space_tags - Listar etiquetas del espacio

• clickup_create_space_tag - Crear etiqueta

• clickup_edit_space_tag - Editar etiqueta

• clickup_delete_space_tag - Eliminar etiqueta

• clickup_add_tag_to_task - Etiquetar una tarea

• clickup_remove_tag_from_task - Quitar etiqueta de una tarea

Listas de verificación (6)

• clickup_create_checklist - Crear lista de verificación

• clickup_edit_checklist - Editar lista de verificación

• clickup_delete_checklist - Eliminar lista de verificación

• clickup_create_checklist_item - Añadir elemento

• clickup_edit_checklist_item - Editar elemento

• clickup_delete_checklist_item - Eliminar elemento

Dependencias (4)

• clickup_add_dependency - Añadir dependencia

• clickup_delete_dependency - Eliminar dependencia

• clickup_add_task_link - Vincular tareas

• clickup_delete_task_link - Desvincular tareas

Comentarios (5)

• clickup_create_comment - Añadir comentario

• clickup_get_comments - Obtener comentarios

• clickup_update_comment - Editar/resolver comentario

• clickup_create_reply - Respuesta en hilo

• clickup_get_replies - Obtener respuestas

Eliminar tarea (1)

• clickup_delete_task - Eliminar una tarea

Pertenencia a múltiples listas (2)

• clickup_add_task_to_list - Añadir una tarea a una lista adicional (multi-homing)

• clickup_remove_task_from_list - Eliminar una tarea de una lista adicional

Estas operaciones no mueven una tarea. La API v2 de ClickUp no tiene un endpoint para mover entre listas. Verificado contra la API en vivo el 2026-08-12: POST /list/{list}/task/{task} añade una ubicación secundaria y deja la lista principal sin cambios, mientras que un list_id en PUT /task/{id} devuelve HTTP 200 y se ignora silenciosamente. Para mover de verdad una tarea y conservar su ID personalizado e historial, usa la interfaz web de ClickUp (clic derecho -> Mover). La pertenencia a múltiples listas también requiere la función de pago Tasks-in-Multiple-Lists.

Miembros del espacio de trabajo (2)

• clickup_get_workspace_members - Todos los miembros del espacio de trabajo

• clickup_get_list_members - Miembros específicos de la lista

Arquitectura

src/
  index.ts          # Entry: McpServer + StdioServerTransport
  client.ts         # ClickUp API v2 fetch wrapper
  types.ts          # Shared Zod schemas + jsonResult helper
  slim.ts           # Response slimming transformers
  tools/
    navigation.ts   # 7 tools
    tasks.ts        # 9 tools (CRUD + custom fields + delete + multi-list)
    tags.ts         # 6 tools
    checklists.ts   # 6 tools
    dependencies.ts # 4 tools
    comments.ts     # 5 tools
    members.ts      # 2 tools

Licencia

MIT