clickup-mcp-full

Un servidor MCP de ClickUp que puede leer un árbol completo de subtareas anidadas en una sola llamada.

Envuelve a @twofeetup/clickup-mcp en lugar de hacerle un fork, así que las correcciones del proyecto original llegan con una actualización de dependencia. Sobre ese servidor añade get_task_tree, reescribe la descripción de una herramienta que suele despistar a los modelos más pequeños y fija un conjunto de herramientas por defecto razonable.

Por qué

La única vía del proyecto original para llegar a las subtareas es search_tasks con include_subtasks, que llama a GET /task/{id}?subtasks=true y devuelve objetos de tarea completos solo para los hijos directos. En una tarea con cincuenta subtareas anidadas a varios niveles, eso resulta a la vez incompleto y nefasto para la ventana de contexto de un agente. La alternativa, una petición por nodo, es peor.

get_task_tree recorre la lista que contiene la tarea una sola vez. GET /list/{id}/task?subtasks=true de ClickUp devuelve todas las tareas de la lista junto con su puntero parent, así que el árbol se reconstruye localmente: dos peticiones en total sin importar la profundidad ni la anchura, y la salida es una línea compacta por tarea.

Task tree for 86capt3b: 23 task(s) including the root.
Statuses: in progress: 3, open: 14, complete: 6
List: Q3 Delivery

86capt3b  [in progress]  Migrate billing service  <ivan>
  86captk1  [complete]  Audit current schema  <olena>
  86captk2  [in progress]  Write migration scripts  <ivan>
    86captm7  [open]  Handle partial refunds
    86captm8  [open]  Backfill historical rows
  86captk3  [open]  Cutover plan

Related MCP server: ClickUp MCP

Instalación

No hay nada que clonar ni compilar. Apunta tu agente al paquete y se descargará en el primer lanzamiento.

Claude Code

claude mcp add clickup_full_local \
  --env CLICKUP_API_KEY=pk_your_token \
  --env CLICKUP_TEAM_ID=9012345678 \
  -- npx -y github:breckenreed/clickup-mcp-full

Claude Desktop, Cursor, Windsurf o cualquiercliente que use mcpServers JSON

{
  "mcpServers": {
    "clickup_full_local": {
      "command": "npx",
      "args": ["-y", "github:breckenreed/clickup-mcp-full"],
      "env": {
        "CLICKUP_API_KEY": "pk_your_token",
        "CLICKUP_TEAM_ID": "9012345678"
      }
    }
  }
}

Hermes (~/.hermes/config.yaml)

mcp_servers:
  clickup_full_local:
    command: npx
    args: ["-y", "github:breckenreed/clickup-mcp-full"]
    env:
      CLICKUP_API_KEY: "${CLICKUP_API_KEY}"
      CLICKUP_TEAM_ID: "${CLICKUP_TEAM_ID}"
    connect_timeout: 60
    keepalive_interval: 60
    idle_timeout_seconds: 1800

Instalación global, si prefieres no resolver desde GitHub en cada lanzamiento:

npm install -g github:breckenreed/clickup-mcp-full

luego usa clickup-mcp-full como comando si argumentos.

Credenciales

Un token personal de ClickUp no tiene alcances propios. Actúa como el usuario que lo creó y hereda los permisos de ese usuario, así que si quieres un agente que no pueda escribir, crea el token con una cuenta de ClickUp de solo visión en lugar de depender de la selección de herramientas.

Herramientas

El proyecto original también incluye attach_file_to_task, que sube un archivo local a ClickUp. Aquí está desactivada por defecto: para un agente que no tiene confirmación por cada acción, convierte cualquier inyección de código que el agente lea en una vía de salida de datos. Actívala deliberadamente si la necesitas:

ENABLED_TOOLS=get_workspace_hierarchy,search_tasks,manage_task,task_comments,get_container,manage_container,find_members,operate_tags,task_time_tracking,attach_file_to_task

Opciones

Sube REQUEST_SPACING en un espacio de trabajo compartido. Por defecto permite alrededor de diez peticiones por segundo, mientras que el límite de ClickUp por token es de unas 100 por minuto a la mayoría de planes. El límite se cntabiliza al token, no a la herramienta, así que un agente que lo agote también rompe cualquier otra integración que use el mismo token. 700 te mantiene por debajo de un tope de 100 por minuto.

Notas sobre el comportamiento

Subtareas en otra lista. El árbol se construye recorriendo la lista que contenga la tarea raíz. Si tu espacio de trabajo coloca las subtareas en una lista distinta de la de sus parent, esas no aparecerán y el servidor volcará a los hijos directos que devuelve el endpoint de tareas. Abre un issue si te ocurre y te importa.

Descripciones de search_tasks. La descripción original ( "Works 3 ways") lleva a los modelos más pequeños a poner un id plano como 86capt3b en customTaskId, que es solo para ids con prefijo como DEV-123. Esa llamada acabayendo en la rama de búsqueda del espacio y falla con "At least one filter parameter is required", un error que señala el problema equivocado, tras el cual el modelo tiende a inventar filtros en lugar de corregir el campo. Este servidor reemplaza esa descripción con la única regla que el modelo realmente necesita.

Ejecación dentro de Docker con un home montado como bind Si tu agente lanza servidores MCP con spec apuntando a un mount bind, npx reconstruye su caché de paquetes en ese montaje cada vez que se conecta, lo que puede llevar unos preciosos minutos y acabar en timeout. En su lugar, instala el paquete globalmente dentro de la imagen y apunta command: al binario.

Solución de problemas

Comprueba que el servidor arranca y lista sus herramientas:

CLICKUP_API_KEY=pk_... CLICKUP_TEAM_ID=... npx -y github:breckenreed/clickup-mcp-full --help

Missing required environment significa que la variables no llegaron al proceso: la mayoría de los clientesi requieren en el bloque env propio, no en tu shell.

Un 401 de cualquier tool significa que el token es incorrecto o fue revocado. Un 429 (Throw 429) se intensifica el límite de velocidad de solicitud: sube REQUEST_SPACING.

Licencia

MIT, como el servidor que envuelve. Los repos @taazkareem/clickup-mcp-server.

• IMPORTANT: Los markdown a veces quedan rotos por las traducciones automáticas, pero aquí se han destruido las . "He propagado el error"

• la entrada en la primera doc: Hey brother, thanks for the lucid explanation. How would I actually…: (Pregunta del usuario)

• Segunda doc: Aclaración: no se pide generalizar, se pregunta por el "gTTP" etc. Así que respuesta may include "por ejemplo, para inyecin...".