Skip to main content
Glama
Sign In
ClickUp MCP Server

ClickUp MCP Server

by mikepsinn
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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:

  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

  1. Replace the credentials and click Save

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

Related MCP server: ClickUp MCP Server

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)

Buy me a coffee

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.

Available Tools

12 tools
create_bulk_tasksA

Create multiple tasks in a ClickUp list. Supports direct name-based lookup for lists - no need to know the list ID. -Tasks will use ClickUp default status if not specified. If the specified list doesn't exist, you can create it using create_list or create_list_in_folder.

Inputs: listId (required), tasks (required), listName.

create_folderA

Create a new folder in a ClickUp space. Supports direct name-based lookup for spaces - no need to know the space ID. If the specified space doesn't exist, you can create it through the ClickUp web interface (space creation via API not supported).

Inputs: name (required), spaceId, spaceName, override_statuses.

create_listA

Create a new list in a ClickUp space. Supports direct name-based lookup for spaces - no need to know the space ID. If the specified space doesn't exist, you can create it through the ClickUp web interface (space creation via API not supported).

Inputs: name (required), spaceId, spaceName, content, +4 more.

create_list_in_folderA

Create a new list in a ClickUp folder. Supports direct name-based lookup for folders and spaces - no need to know IDs. If the specified folder doesn't exist, you can create it using create_folder. If the space doesn't exist, it must be created through the ClickUp web interface.

Inputs: name (required), folderId, folderName, spaceId, +3 more.

create_taskA

Create a new task in ClickUp. Supports direct name-based lookup for lists - no need to know the list ID. -Status will use ClickUp defaults if not specified. If the specified list doesn't exist, you can create it using create_list or create_list_in_folder.

Inputs: name (required), listId, listName, description, +4 more.

delete_taskB

Delete a task from your workspace. This action cannot be undone.

Inputs: taskId (required).

duplicate_taskA

Duplicate a task to a list. Supports direct name-based lookup for lists - no need to know the list ID. If the destination list doesn't exist, you can create it using create_list or create_list_in_folder.

Inputs: taskId, taskName, sourceListName, listId, +1 more.

get_taskA

Get detailed information about a specific ClickUp task, including attachments. Supports direct name-based lookup for tasks.

Inputs: taskId, taskName, listName.

get_tasksA

Get tasks from a ClickUp list with optional filters. Supports direct name-based lookup for lists - no need to know the list ID. If the list doesn't exist, you can create it using create_list or create_list_in_folder.

Inputs: listId, listName, archived, page, +13 more.

get_workspace_hierarchyA

Get the complete hierarchy of spaces, folders, and lists in the workspace. -First check chat history for space, folder, and list names or IDs. If not found, use this tool to get necessary information.

Inputs: no named parameters.

move_taskA

Move a task to a different list. Supports direct name-based lookup for lists and tasks - no need to know IDs.

Inputs: taskId, taskName, sourceListName, listId, +1 more.

update_taskA

Update an existing task in ClickUp. Supports direct name-based lookup for tasks - no need to know the task ID.

Inputs: taskId, taskName, listName, name, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: tasks have separate create, read, update, delete, duplicate, move, and bulk operations; lists have two creation variants; folders have one; and workspace hierarchy provides navigation. No overlapping purposes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_task, get_workspace_hierarchy, delete_task). No mixing of conventions or vague verbs.

    Tool Count5/5

    12 tools is well-scoped for a project management server covering tasks, lists, and folders. Each tool earns its place without redundancy or excessive granularity.

    Completeness3/5

    The set covers full CRUD for tasks but lacks update and delete for lists and folders. Space management is minimal (only hierarchy view, creation requires web interface). Some notable gaps like list/folder modification and task search beyond list scope.

    Resources

    Related MCP Connectors

    Related MCP Servers