local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables interaction with ClickUp workspaces, providing tools for task management (creating and updating tasks), team and list management (retrieving teams and lists), and board management (creating boards).

Servidor MCP de ClickUp

Una implementación de servidor de protocolo de contexto de modelo para la integración de ClickUp, que permite que los asistentes de IA interactúen con los espacios de trabajo de ClickUp.

Inicio rápido

Configurar Claude para escritorio:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@mcp/clickup-server"],
      "env": {
        "CLICKUP_CLIENT_ID": "your_client_id",
        "CLICKUP_CLIENT_SECRET": "your_client_secret",
        "CLICKUP_REDIRECT_URI": "http://localhost:3000/oauth/callback"
      }
    }
  }
}

Reiniciar Claude para escritorio

¡Listo! El servidor se descargará e iniciará automáticamente cuando sea necesario.

Instalación mediante herrería

Para instalar ClickUp MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude

Variables de entorno

Variables de entorno requeridas:

CLICKUP_CLIENT_ID : Su ID de cliente OAuth de ClickUp
CLICKUP_CLIENT_SECRET : Su secreto de cliente OAuth de ClickUp
CLICKUP_REDIRECT_URI : URI de redirección de OAuth (predeterminado: http://localhost:3000/oauth/callback )

Variables de entorno opcionales:

PORT : Puerto del servidor (predeterminado: 3000)
LOG_LEVEL : Nivel de registro (predeterminado: información)

Herramientas disponibles

Gestión de tareas

clickup_create_task : Crea una nueva tarea en una lista de ClickUp
clickup_update_task : Actualizar las propiedades de una tarea existente

Gestión de equipos y listas

clickup_get_teams : Recuperar todos los equipos accesibles
clickup_get_lists : Obtener todas las listas en una carpeta específica

Junta Directiva

clickup_create_board : Crea un nuevo tablero en un espacio ClickUp

Desarrollo

Clonar el repositorio
Instalar dependencias:

npm install

Iniciar en modo de desarrollo:

npm run dev

Construir para producción:

npm run build

Ejecutar pruebas:

npm test

Seguridad

Todos los tokens están encriptados en reposo
Flujo OAuth2 para autenticación segura
No se registran datos confidenciales
Limitación de velocidad para evitar el abuso de la API

Solución de problemas

Problemas comunes

Errores de autenticación
- Verifique sus credenciales de OAuth en las variables de entorno
- Comprobar la caducidad del token
- Asegúrese de que la URL de redirección sea correcta
Limitación de velocidad
- El servidor implementa el manejo automático del límite de velocidad
- Consulte los registros para ver las advertencias sobre el límite de velocidad
- Considere implementar la agrupación de solicitudes
El servidor no se inicia
- Compruebe que las variables de entorno estén configuradas correctamente
- Verificar que el puerto 3000 esté disponible
- Consulta los registros de Claude para el escritorio

Obteniendo registros

Los registros de Claude for Desktop se pueden encontrar en:

Windows: %USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log
macOS: ~/Library/Logs/Claude/mcp*.log

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Este servidor integra asistentes de IA con espacios de trabajo de ClickUp, lo que permite la gestión de tareas, equipos, listas y tableros a través de un proceso de autenticación OAuth2 seguro.

Related Resources

Reddit Discussion about this server