ClickUp 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:

1. Get your credentials:

   • ClickUp API key from ClickUp Settings

   • Team ID from your ClickUp workspace URL

2. Go to Features in settings

3. 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

4. Replace the credentials and click Save

5. Use Natural Language to interact with your ClickUp Workspace!

Features

• 🎯 Task Management

  • Create, update, and delete tasks

  • Move and duplicate tasks between lists, spaces, and folders

  • Bulk task operations

  • Task details

• 📂 Workspace Organization

  • Hierarchical tree structure with clear relationships

  • Efficient navigation with path tracking

  • List and folder management in spaces

  • Smart caching to reduce API calls

  • Name/ID-based item lookup

  • Optimized task organization

• 🔄 Smart Integration

  • Case-insensitive name lookups

  • Markdown support

  • Automatic rate limiting

  • Error handling

• 🤖 AI Assistance

  • Task analysis and insights

  • Status summaries and priorities

  • Description assistance

  • Relationship mapping

Available Tools

Workspace Tools

get_workspace_hierarchy Returns complete workspace structure (spaces, folders, lists). No parameters required.

Task Tools

get_tasks (listId|listName) Get tasks from list with optional filters (archived, page, order_by, reverse, subtasks, statuses, include_closed, assignees, due_date_gt/lt, custom_fields).

get_task (taskId|taskName, ?listName) Get detailed task info including attachments and custom fields.

create_task (listId|listName, taskName) Create task with optional description (markdown), status, priority (1-4), dueDate.

create_bulk_tasks (listId|listName, tasks[]) Bulk create tasks with automatic rate limiting. Each task: name (required), description, status, priority, dueDate (optional).

update_task (taskId|taskName, ?listName) Update task name, description, status, priority (1-4), dueDate.

delete_task (taskId|taskName, ?listName) Permanently delete a task.

move_task (taskId|taskName, destinationListId|destinationListName, ?sourceListName) Move task to different list, preserving task data.

duplicate_task (taskId|taskName, destinationListId|destinationListName, ?sourceListName) Create copy of task in specified list.

List & Folder Tools

create_list (spaceId|spaceName, listName) Create list with optional content, dueDate, priority (1-4), assignee.

create_folder (spaceId|spaceName, folderName, ?overrideStatuses) Create folder in space.

create_list_in_folder (folderId|folderName, listName) Create list in folder with optional content and status.

Available Prompts

1. summarize_tasks

   • Basic task summary by status

   • Lists tasks with their current states

   • Shows task relationships within lists

2. analyze_priorities

   • Reviews current task priorities

   • Suggests priority adjustments

   • Recommends task sequencing

3. generate_description

   • Interactive prompt for creating task descriptions

   • Helps structure task information

   • Includes objectives, criteria, and 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 the developer: Talib Kareem (taazkareem@icloud.com)

Solana Wallet: GjtRksihd7SWQw7hJSCDMcTxPHbgpNs7xPW3nFubNjVM

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.