Package Exports
- @taazkareem/clickup-mcp-server
- @taazkareem/clickup-mcp-server/build/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@taazkareem/clickup-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
MCP Server
A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.
Quick Start
Directions for use with Cursor Composer Agent:
- Get your credentials:
- ClickUp API key from ClickUp Settings
- Team ID from your ClickUp workspace URL
- Go to Features in settings
- Add under MCP Servers:
npx -y @taazkareem/clickup-mcp-server \
--env CLICKUP_API_KEY=your_api_key_here \
--env CLICKUP_TEAM_ID=your_team_id_here- Replace the credentials and click Save
- Use Natural Language to interact with your ClickUp Workspace!
Features
🎯 Task Management
- Create, update, and delete individual tasks
- Move and duplicate tasks between lists, spaces, and folders
- Create multiple tasks in bulk
- View and modify task details and properties
📂 Workspace Organization
- Complete workspace hierarchy (spaces, folders, lists)
- Tree structure with clear relationships
- Create and manage lists and folders
- Efficient path-based navigation
🔄 Integration Features
- Name or ID-based item lookup
- Case-insensitive name matching
- Markdown formatting support
- Built-in API rate limiting
🤖 AI-Powered Analysis
- Task status summaries and overviews
- Priority analysis and recommendations
- Structured description generation
- Task relationship mapping
Available Tools
| Tool | Description | Required Parameters |
|---|---|---|
| get_workspace_hierarchy | Get workspace structure | None |
| create_task | Create a task | name, (listId/listName) |
| create_bulk_tasks | Create multiple tasks | tasks[] |
| update_task | Modify task | taskId/taskName |
| get_tasks | Get tasks from list | listId/listName |
| get_task | Get task details | taskId/taskName |
| delete_task | Remove task | taskId |
| move_task | Move task | taskId/taskName, listId/listName |
| duplicate_task | Copy task | taskId/taskName, listId/listName |
| create_list | Create list in space | name, spaceId/spaceName |
| create_folder | Create folder | name, spaceId/spaceName |
| create_list_in_folder | Create list in folder | name, folderId/folderName |
See full documentation for optional parameters and advanced usage.
Available Prompts
| Prompt | Purpose | Features |
|---|---|---|
| summarize_tasks | Task overview | Status summary, priorities, relationships |
| analyze_priorities | Priority optimization | Distribution analysis, sequencing |
| generate_description | Task description creation | Objectives, criteria, dependencies |
Error Handling
The server provides clear error messages for:
- Missing required parameters
- Invalid IDs or names
- Items not found
- Permission issues
- API errors
- Rate limiting
Support the Developer
If you find this project useful, please consider supporting
Contributing
Contributions are welcome! Please read our Contributing Guide for details.
License
This project is licensed under the MIT License - see the LICENSE file for details.