This project provides a Model Context Protocol (MCP) server to integrate ClickUp project management with AI agents, enabling natural language interaction with tasks, documents, and workspace organization. It targets AI developers and power users seeking to automate project management workflows.

How It Works

The server acts as a bridge, translating AI agent requests into ClickUp API calls. It supports both modern HTTP Streamable transport and legacy SSE for broad compatibility. The architecture emphasizes zero code duplication and a unified approach across transports, aiming for improved performance and maintainability.

Quick Start & Requirements

• Install/Run: npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id
• Prerequisites: ClickUp API key, ClickUp Team ID.
• Configuration: DOCUMENT_SUPPORT (boolean), ENABLED_TOOLS, DISABLED_TOOLS, ENABLE_SSE (boolean), PORT.
• Docs: Full documentation for optional parameters and advanced usage.

Highlighted Details

• Supports 36 distinct tools for comprehensive ClickUp management, including task, tag, time tracking, document, and member operations.
• Features natural language processing for dates, task assignments, and tag management.
• Offers flexible tool filtering via ENABLED_TOOLS and DISABLED_TOOLS environment variables.
• Includes error handling, rate limiting, and configurable log levels.

Maintenance & Community

• Actively maintained with recent updates (v0.8.3) addressing enhancements and bug fixes.
• Contributions are welcome via a contributing guide.

Licensing & Compatibility

• MIT License.
• Compatible with commercial and closed-source applications.

Limitations & Caveats

• Prompt implementation for AI-driven workflows is not yet fully implemented or universally supported by client apps.
• The project may display sponsor messages in tool responses to support the developer.