A
security-
licenseA
qualityThis server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
27
17
MIT License
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
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
Elija entre la instalación alojada (envía webhooks) o la instalación NPX (descarga a la ruta local e instala dependencias)
¡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:
{
"mcpServers": {
"ClickUp": {
"command": "npx",
"args": [
"-y",
"@taazkareem/clickup-mcp-server@latest"
],
"env": {
"CLICKUP_API_KEY": "your-api-key",
"CLICKUP_TEAM_ID": "your-team-id",
"DOCUMENT_SUPPORT": "true"
}
}
}
}
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:
{
"mcpServers": {
"ClickUp": {
"command": "npx",
"args": [
"-y",
"@taazkareem/clickup-mcp-server@latest"
],
"env": {
"CLICKUP_API_KEY": "your-api-key",
"CLICKUP_TEAM_ID": "your-team-id",
"ENABLE_SSE": "true",
"PORT": "8000" // Optional, defaults to 3231
}
}
}
}
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
version: '3.8'
services:
clickup-mcp-server:
build:
context: .
dockerfile: Dockerfile
ports:
- '3231:8000'
environment:
- CLICKUP_API_KEY=${CLICKUP_API_KEY}
- CLICKUP_TEAM_ID=${CLICKUP_TEAM_ID}
- ENABLE_SSE=true
- LOG_LEVEL=info
- DOCUMENT_SUPPORT=true
volumes:
- ./src:/app/src
restart: unless-stopped
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
interval: 30s
timeout: 10s
retries: 3
start_period: 5s
Características
📝 Gestión de tareas | 🏷️ Gestión de etiquetas |
• Crear, actualizar y eliminar tareas• Mover y duplicar tareas en cualquier lugar• Soporte para operaciones individuales y masivas• Establecer fechas de inicio/vencimiento con lenguaje natural• Crear y administrar subtareas• Agregar comentarios y archivos adjuntos | • Crear, actualizar y eliminar etiquetas de espacio• Agregar y eliminar etiquetas de tareas• Usar comandos de color en lenguaje natural• Colores de primer plano con contraste automático• Ver todas las etiquetas de espacio• Organización de tareas basada en etiquetas en todo el espacio de trabajo |
⏱️ Seguimiento del tiempo | 🌳 Organización del espacio de trabajo |
• Ver entradas de tiempo para tareas• Iniciar/detener el seguimiento del tiempo en tareas• Agregar entradas de tiempo manuales• Eliminar entradas de tiempo• Ver el temporizador en ejecución• Realizar un seguimiento del tiempo facturable y no facturable | • Navegar por espacios, carpetas y listas• Crear y administrar carpetas• Organizar listas dentro de espacios• Crear listas en carpetas• Ver la jerarquía del espacio de trabajo• Navegación de ruta eficiente |
📄 Gestión de documentos | 👥 Gestión de miembros |
• Listado de documentos a través de todo el espacio de trabajo • Listado de páginas de documentos • Detalles de páginas de documentos • Creación de documentos • Actualización de páginas de documentos (añadir y anteponer) | • Buscar miembros del espacio de trabajo por nombre o correo electrónico• Resolver asignaciones para tareas• Ver detalles y permisos de los miembros• Asignar tareas a los usuarios durante la creación• Soporte para ID de usuario, correos electrónicos o nombres de usuario• Administración de usuarios de todo el equipo |
⚡ Funciones de integración | |
• Búsquedas globales basadas en nombre o ID • Coincidencia sin distinción entre mayúsculas y minúsculas • Compatibilidad con formato Markdown • Limitación de velocidad integrada • Manejo y validación de errores • Cobertura completa de API |
Herramientas disponibles
Herramienta | Descripción | Parámetros requeridos |
Obtener la estructura del espacio de trabajo | Ninguno | |
Crear una tarea |
, (
/
) | |
Crear múltiples tareas |
| |
Modificar tarea |
/
| |
Actualizar múltiples tareas |
con ID o nombres | |
Obtener tareas de la lista |
/
| |
Obtener detalles de una sola tarea |
/
(con desambiguación inteligente) | |
Obtener tareas con filtrado | Al menos un filtro (etiquetas, list_ids, space_ids, etc.) | |
Obtener comentarios sobre una tarea |
/
| |
Agregar un comentario a una tarea |
, (
/(
+
)) | |
Adjuntar archivo a una tarea |
/
, (
o
) | |
Eliminar tarea |
/
| |
Eliminar varias tareas |
con ID o nombres | |
Tarea de movimiento |
/
,
/
| |
Mover múltiples tareas |
con ID o nombres, lista de objetivos | |
Copiar tarea |
/
,
/
| |
Crear lista en el espacio |
,
/
| |
Crear carpeta |
,
/
| |
Crear lista en la carpeta |
,
/
| |
Obtener detalles de la carpeta |
/
| |
Actualizar las propiedades de la carpeta |
/
| |
Eliminar carpeta |
/
| |
Obtener detalles de la lista |
/
| |
Actualizar propiedades de la lista |
/
| |
Eliminar lista |
/
| |
Obtener etiquetas de espacio |
/
| |
Crear etiqueta |
,
/
| |
Actualizar etiqueta |
,
/
| |
Eliminar etiqueta |
,
/
| |
Agregar etiqueta a la tarea |
,
/(
+
) | |
Eliminar etiqueta de la tarea |
,
/(
+
) | |
Obtener entradas de tiempo para una tarea |
/
| |
Iniciar el seguimiento del tiempo en una tarea |
/
| |
Detener el seguimiento del tiempo actual | Ninguno | |
Agregar entrada de tiempo manual a una tarea |
/
,
,
| |
Eliminar una entrada de tiempo |
| |
Obtener el temporizador que se está ejecutando actualmente | Ninguno | |
Obtener todos los miembros del espacio de trabajo | Ninguno | |
Buscar miembro por nombre o correo electrónico |
| |
Resolver nombres de miembros a ID |
| |
Crear un documento |
,
,
/
,
,
| |
Obtener un documento |
/
| |
Lista de documentos |
,
/
/
/
/
/
/
/
| |
Lista de páginas del documento |
/
| |
Obtener páginas del documento |
/
,
| |
Crear una página de documento |
/
,
/
/
,
/
| |
Actualizar una página de un documento |
/
,
/
,
/
/
|
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:
{
"name": "New Task",
"description": "This is a new task.",
"assignees": ["jdoe@example.com", "Jane Smith"] // Emails, usernames, or user IDs
}
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:
Inmediato | Objetivo | Características |
Descripción general de la tarea | Resumen de estado, prioridades, relaciones | |
Optimización de prioridades | Análisis de distribución, secuenciació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
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.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Permite integraciones de IA con tareas de ClickUp, lo que respalda la gestión de recursos, las operaciones de tareas, la organización del espacio de trabajo y las recomendaciones de tareas impulsadas por IA a través de un protocolo estandarizado.
- Instalación de herrería (inicio rápido)
- Instalación de NPX
- Corriendo con soporte SSE
- Ejemplo de Docker-compose
- Características
- Herramientas disponibles
- Herramientas de gestión de miembros
- Indicaciones
- Manejo de errores
- Apoyar al desarrollador
- Expresiones de gratitud
- Contribuyendo
- Licencia
- Descargo de responsabilidad
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityAn enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.Last updated -02MIT License
- -security-license-qualityA Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.Last updated -1,7342MIT License
- Asecurity-licenseAqualityEnables AI assistants to interact with ClickUp's task management API for core project workflows, supporting operations like task creation, updates, search, assignment, and team analytics through natural language.Last updated -283MIT License
Appeared in Searches
- A method or tool for managing ClickUp task list custom fields with read and write update capabilities
- Automating Task Assignment Based on Priority with Reshuffling Capabilities
- Tools and platforms for task management
- A tool for planning and managing software projects
- A server for software engineers that integrates with Jira and Slack