ClickUp MCP Integration

by Leanware-io
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables interaction with ClickUp workspaces, providing tools for creating new tasks with various properties (descriptions, priority levels, due dates, tags), retrieving detailed task information by task ID, and looking up tasks using custom IDs.

Integración de ClickUp MCP

Un servidor de protocolo de contexto de modelo que proporciona una integración perfecta con ClickUp, lo que permite que los modelos de lenguaje grandes interactúen con las tareas y los datos de su espacio de trabajo de ClickUp.

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas para interactuar con ClickUp:

clickup_create_task

Crea una nueva tarea en su espacio de trabajo de ClickUp.

  • Entradas requeridas :
    • name (cadena): nombre de la tarea
    • list_id (cadena): ID de la lista de ClickUp donde se creará la tarea
  • Entradas opcionales :
    • markdown_description (cadena): Descripción de la tarea en formato markdown
    • priority (número): Prioridad de la tarea (1=Urgente, 2=Alta, 3=Normal, 4=Baja)
    • due_date (número): fecha de vencimiento como marca de tiempo Unix en milisegundos
    • tags (matriz de cadenas): nombres de etiquetas para agregar a la tarea
    • time_estimate (número): Estimación de tiempo en milisegundos
  • Devuelve : Detalles de la tarea recién creada

clickup_get_task

Recupera información detallada sobre una tarea específica utilizando su ID.

  • Entradas requeridas :
    • task_id (cadena): El ID de la tarea ClickUp
  • Devoluciones : Detalles completos de la tarea, incluyendo descripción, estado, asignados y metadatos

clickup_get_task_by_custom_id

Recupera información de la tarea utilizando una identificación personalizada.

  • Entradas requeridas :
    • custom_id (cadena): El ID personalizado de la tarea
  • Devoluciones : Detalles completos de la tarea, incluyendo descripción, estado, asignados y metadatos

Construir

Correr:

npm i npm run build npm run inspector

Compilación de Docker:

docker buildx build -t {your-docker-repository} --platform linux/amd64,linux/arm64 . docker push {your-docker-repository}

Configuración

1. Cómo obtener tu token API de ClickUp:

  1. Inicie sesión en su cuenta de ClickUp en app.clickup.com
  2. Navega a tu configuración de usuario haciendo clic en tu foto de perfil en la esquina inferior izquierda
  3. Seleccione "Configuración"
  4. Haga clic en "Aplicaciones" en la barra lateral izquierda.
  5. En "Token API", haga clic en "Generar" si aún no tiene un token
  6. Copiar el token API generado para usarlo en la configuración del servidor MCP

2. Cómo encontrar el ID de su espacio de trabajo:

  1. Abra ClickUp en su navegador web
  2. Mira la URL cuando estés en tu espacio de trabajo
  3. El ID del espacio de trabajo es el valor numérico en la URL: https://app.clickup.com/{workspace_id}/home
  4. Copie este número para usarlo en la configuración del servidor MCP

3. Instalar Docker: https://docs.docker.com/engine/install/

4a. Configurar el servidor Cline MCP:

  • Abra VSCode o Jetbrains IDE y vaya a Cline.
  • Vaya a Servidores MCP → Instalados → Configurar servidores MCP.
  • Agregue lo siguiente a su cline_mcp_settings.json dentro de la clave mcpServers :
"clickup": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "CLICKUP_API_TOKEN", "-e", "CLICKUP_WORKSPACE_ID", "your-docker-repository" ], "env": { "CLICKUP_API_TOKEN": "your-api-token", "CLICKUP_WORKSPACE_ID": "your-workspace-id" } }

4b. Configurar el servidor MCP de Claude Desktop:

  • Utilice cualquier editor para abrir el archivo de configuración de Claude Desktop.
    • Windows: C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json
    • Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Agregue lo siguiente a su claude_desktop_config.json dentro de la clave mcpServers :
"clickup": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "CLICKUP_API_TOKEN", "-e", "CLICKUP_WORKSPACE_ID", "your-docker-repository" ], "env": { "CLICKUP_API_TOKEN": "your-api-token", "CLICKUP_WORKSPACE_ID": "your-workspace-id" } }
  • Guardar el archivo de configuración
  • Reinicie Claude Desktop para aplicar los cambios

Solución de problemas

Si encuentra problemas con el servidor MCP:

  1. Errores de autenticación :
    • Verifique que su token API sea correcto
    • Asegúrese de que el token de API tenga los permisos necesarios para las operaciones que está intentando realizar
    • Comprueba que el ID de tu espacio de trabajo sea correcto
  2. Problemas de acceso a tareas :
    • Confirme que tiene acceso a las tareas que está intentando recuperar
    • Verifique que los ID de las tareas sean correctos y existan en su espacio de trabajo
    • Comprueba si las tareas podrían estar en estado archivado
  3. Problemas de conexión :
    • Asegúrese de que su servicio Docker se esté ejecutando correctamente
    • Comprueba tu conexión de red
    • Verifique que las variables de entorno estén configuradas correctamente en su configuración de MCP

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que usted tiene libertad de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor de protocolo de contexto de modelo que permite que los modelos de lenguaje grandes interactúen con las tareas y los datos del espacio de trabajo de ClickUp, lo que permite la creación y recuperación de tareas a través del lenguaje natural.

  1. Available Tools
    1. clickup_create_task
    2. clickup_get_task
    3. clickup_get_task_by_custom_id
  2. Build
    1. Setup
      1. Troubleshooting
    2. License
      ID: mcxzcscusd