Servidor MCP

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: - Se completó la refactorización del código. - La funcionalidad de fecha de vencimiento mejorada ahora admite expresiones de tiempo relativo como "dentro de 2 horas" con la visualización correcta del tiempo en ClickUp. - El comando npx se actualizó para usar @latest, que debería actualizar automáticamente el servidor cuando se lanza una nueva versión. - El servidor se ha incluido en Smithery, Glama y Pulse MCP.

Inicio rápido

Instrucciones de uso con Cursor Composer Agent:

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
Vaya a Características en la configuración (o Servidores MCP según la versión)
Agregar en Servidores MCP:

npx -y @taazkareem/clickup-mcp-server@latest \
  --env CLICKUP_API_KEY=your_api_key_here \
  --env CLICKUP_TEAM_ID=your_team_id_here

Reemplace las credenciales y haga clic en Guardar
¡Utilice el lenguaje natural para interactuar con su espacio de trabajo de ClickUp!

Instalación de herrería

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

Características

🎯 Gestión de tareas
- Crear, actualizar y eliminar tareas individuales
- Mover y duplicar tareas entre listas, espacios y carpetas
- Crear, actualizar, mover y eliminar múltiples tareas en masa
- Ver y modificar detalles y propiedades de la tarea
- Establezca fechas de vencimiento utilizando lenguaje natural y expresiones de tiempo relativo
📂 Organización del espacio de trabajo
- Jerarquía completa del espacio de trabajo (espacios, carpetas, listas)
- Estructura de árbol con relaciones claras
- Operaciones CRUD completas para componentes del espacio de trabajo
- Navegación eficiente basada en rutas
🔄 Funciones de integración
- Búsqueda de artículos basada en nombre o ID
- Coincidencia de nombres sin distinción entre mayúsculas y minúsculas
- Compatibilidad con formato Markdown
- Limitación de velocidad de API incorporada

Herramientas disponibles

Herramienta	Descripción	Parámetros requeridos
obtener_jerarquía_del_espacio_de_trabajo	Obtener la estructura del espacio de trabajo	Ninguno
crear_tarea	Crear una tarea	`name` , ( `listId` / `listName` )
crear_tareas_en_masa	Crear múltiples tareas	`tasks[]`
tarea de actualización	Modificar tarea	`taskId` / `taskName`
actualizar_tareas_masivas	Actualizar múltiples tareas	`tasks[]` con ID o nombres
obtener_tareas	Obtener tareas de la lista	`listId` / `listName`
obtener_tarea	Obtener detalles de la tarea	`taskId` / `taskName`
eliminar_tarea	Eliminar tarea	`taskId` / `taskName`
eliminar_tareas_en_masa	Eliminar varias tareas	`tasks[]` con ID o nombres
mover_tarea	Tarea de movimiento	`taskId` / `taskName` , `listId` / `listName`
mover_tareas_en_masa	Mover múltiples tareas	`tasks[]` con ID o nombres, lista de objetivos
tarea duplicada	Copiar tarea	`taskId` / `taskName` , `listId` / `listName`
crear_lista	Crear lista en el espacio	`name` , `spaceId` / `spaceName`
crear_carpeta	Crear carpeta	`name` , `spaceId` / `spaceName`
crear_lista_en_carpeta	Crear lista en la carpeta	`name` , `folderId` / `folderName`
obtener_carpeta	Obtener detalles de la carpeta	`folderId` / `folderName`
carpeta_de_actualización	Actualizar las propiedades de la carpeta	`folderId` / `folderName`
eliminar_carpeta	Eliminar carpeta	`folderId` / `folderName`
obtener_lista	Obtener detalles de la lista	`listId` / `listName`
lista de actualizaciones	Actualizar propiedades de la lista	`listId` / `listName`
lista de eliminación	Eliminar lista	`listId` / `listName`

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

Indicaciones disponibles

Aún no implementado (o necesario) Por ahora, puedes enviar un mensaje de seguimiento después del resultado de la herramienta.

Inmediato	Objetivo	Características
resumir_tareas	Descripción general de la tarea	Resumen de estado, prioridades, relaciones
analizar_prioridades	Optimización de prioridades	Análisis de distribución, secuenciación
generar_descripción	Creación de descripción de tareas	Objetivos, criterios, dependencias

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

Apoyar al desarrollador

Si encuentra este proyecto útil, considere apoyarlo.

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

Aviso legal: 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 marcas son propiedad de sus respectivos dueños. Este proyecto es independiente y no está asociado ni patrocinado oficialmente por ninguna de las empresas mencionadas.

ClickUp MCP Server

Integrations