ClickUp MCP Server

Un servidor de Protocolo de Contexto de Modelo (MCP) para integrar tareas de ClickUp con aplicaciones de IA. Este servidor permite a los agentes de IA interactuar con tareas, espacios, listas y carpetas de ClickUp mediante un protocolo estandarizado.

🚀 Actualización de estado: v0.7.2 ahora disponible con soporte completo de seguimiento de tiempo y funciones de gestión de documentos.

Configuración

1. Obtenga sus credenciales:
   • Clave API de ClickUp desde la configuración de ClickUp
   • ID de equipo de la URL de su espacio de trabajo de ClickUp
2. Elija entre la instalación alojada (envía webhooks) o la instalación NPX (descarga a la ruta local e instala dependencias)
3. ¡Utiliza el lenguaje natural para gestionar tu espacio de trabajo!

Instalación de herrería (inicio rápido)

El servidor está alojado en Smithery . Allí, puedes previsualizar las herramientas disponibles o copiar los comandos para ejecutarlos en tu aplicación cliente.

Instalación de NPX

Agregue esta entrada al archivo JSON de configuración MCP de su cliente:

O use este comando npx:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

Nota: si no pasa "DOCUMENT_SUPPORT": "true", el valor predeterminado es falso y el soporte de documentos no estará activo.

Además, puede usar la variable de entorno DISABLED_TOOLS o el argumento --env DISABLED_TOOLS para deshabilitar herramientas específicas. Proporcione una lista separada por comas de los nombres de las herramientas que desea deshabilitar (p. ej., create_task,delete_task ).

Deshabilite las herramientas que no necesita si tiene problemas con la cantidad de herramientas o alguna limitación de contexto.

Corriendo con soporte SSE

El servidor se puede ejecutar en modo SSE (eventos enviados por el servidor) configurando las siguientes variables de entorno:

O mediante la línea de comandos:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id --env ENABLE_SSE=true --env PORT=8000

Ejemplo de Docker-compose

Características

Herramientas disponibles

Consulte la documentación completa para conocer los parámetros opcionales y el uso avanzado.

Herramientas de gestión de miembros

Al crear tareas, ahora puede asignar usuarios mediante el parámetro assignees . Este parámetro acepta una matriz de ID de usuario, correo electrónico o nombre de usuario:

Las herramientas de gestión de miembros ayudan a resolver las referencias de usuarios cuando sea necesario.

Indicaciones

Aún no se ha implementado y no es compatible con todas las aplicaciones cliente. Solicite una función para una implementación rápida que sea más beneficiosa para su flujo de trabajo (sin ser demasiado específica). Ejemplos:

Manejo de errores

El servidor proporciona mensajes de error claros para:

• Faltan parámetros requeridos
• Identificaciones o nombres no válidos
• Elementos no encontrados
• Problemas de permisos
• Errores de API
• Limitación de velocidad

La variable de entorno LOG_LEVEL se puede especificar para controlar el nivel de detalle de los registros del servidor. Los valores válidos son trace , debug , info , warn y error (predeterminado). Esto también se puede especificar en la línea de comandos, por ejemplo, con --env LOG_LEVEL=info .

Apoyar al desarrollador

Al usar este servidor, es posible que ocasionalmente veas un pequeño mensaje de patrocinador con un enlace a este repositorio en las respuestas de la herramienta. ¡Espero que puedas apoyar el proyecto! Si te resulta útil, considera apoyar:

Expresiones de gratitud

Un agradecimiento especial a ClickUp por su excelente API y servicios que hacen posible esta integración.

Contribuyendo

¡Agradecemos sus contribuciones! Para más detalles, consulte nuestra Guía de Contribución .

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Descargo de responsabilidad

Este software utiliza API de terceros y puede hacer referencia a marcas comerciales o marcas propiedad de terceros. El uso de dichas API o referencias no implica afiliación ni respaldo alguno por parte de las respectivas empresas. Todas las marcas comerciales y nombres de marca son propiedad de sus respectivos dueños. Este proyecto es independiente y no está asociado ni patrocinado oficialmente por ninguna de las empresas mencionadas.