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.