ClickUp MCP Server

Total Supporters

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.

🚀 Status Update: v0.7.2 now available with complete Time Tracking support and Document Management features.

Setup

Get your credentials:
- ClickUp API key from ClickUp Settings
- Team ID from your ClickUp workspace URL
Choose either hosted installation (sends webhooks) or NPX installation (downloads to local path and installs dependencies)
Use natural language to manage your workspace!

Smithery Installation (Quick Start)

The server is hosted on Smithery. There, you can preview the available tools or copy the commands to run on your specific client app.

NPX Installation

Add this entry to your client's MCP settings JSON file:

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "@taazkareem/clickup-mcp-server@latest"
      ],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "DOCUMENT_SUPPORT": "true"
      }
    }
  }
}

Or use this npx command:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

Obs: if you don't pass "DOCUMENT_SUPPORT": "true", the default is false and document support will not be active.

Additionally, you can use the DISABLED_TOOLS environment variable or --env DISABLED_TOOLS argument to disable specific tools. Provide a comma-separated list of tool names to disable (e.g., create_task,delete_task).

Please disable tools you don't need if you are having issues with the number of tools or any context limitations

Running with SSE Support

Server can be run in SSE (Server-Sent Events) mode by setting the following environment variables:

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "@taazkareem/clickup-mcp-server@latest"
      ],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "ENABLE_SSE": "true",
        "PORT": "8000"  // Optional, defaults to 3231
      }
    }
  }
}

Or via command line:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id --env ENABLE_SSE=true --env PORT=8000

Docker-compose example

version: '3.8'

services:
  clickup-mcp-server:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - '3231:8000'
    environment:
      - CLICKUP_API_KEY=${CLICKUP_API_KEY}
      - CLICKUP_TEAM_ID=${CLICKUP_TEAM_ID}
      - ENABLE_SSE=true
      - LOG_LEVEL=info
      - DOCUMENT_SUPPORT=true
    volumes:
      - ./src:/app/src
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 5s

Features

📝 Task Management	🏷️ Tag Management
• Create, update, and delete tasks• Move and duplicate tasks anywhere• Support for single and bulk operations• Set start/due dates with natural language• Create and manage subtasks• Add comments and attachments	• Create, update, and delete space tags• Add and remove tags from tasks• Use natural language color commands• Automatic contrasting foreground colors• View all space tags• Tag-based task organization across workspace
⏱️ Time Tracking	🌳 Workspace Organization
• View time entries for tasks• Start/stop time tracking on tasks• Add manual time entries• Delete time entries• View currently running timer• Track billable and non-billable time	• Navigate spaces, folders, and lists• Create and manage folders• Organize lists within spaces• Create lists in folders• View workspace hierarchy• Efficient path navigation
📄 Document Management	👥 Member Management
• Document Listing through all workspace• Document Page listing• Document Page Details• Document Creation• Document page update (append & prepend)	• Find workspace members by name or email• Resolve assignees for tasks• View member details and permissions• Assign tasks to users during creation• Support for user IDs, emails, or usernames• Team-wide user management
⚡ Integration Features
• Global name or ID-based lookups• Case-insensitive matching• Markdown formatting support• Built-in rate limiting• Error handling and validation• Comprehensive API coverage

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`
update_bulk_tasks	Update multiple tasks	`tasks[]` with IDs or names
get_tasks	Get tasks from list	`listId`/`listName`
get_task	Get single task details	`taskId`/`taskName` (with smart disambiguation)
get_workspace_tasks	Get tasks with filtering	At least one filter (tags, list_ids, space_ids, etc.)
get_task_comments	Get comments on a task	`taskId`/`taskName`
create_task_comment	Add a comment to a task	`commentText`, (`taskId`/(`taskName`+`listName`))
attach_task_file	Attach file to a task	`taskId`/`taskName`, (`file_data` or `file_url`)
delete_task	Remove task	`taskId`/`taskName`
delete_bulk_tasks	Remove multiple tasks	`tasks[]` with IDs or names
move_task	Move task	`taskId`/`taskName`, `listId`/`listName`
move_bulk_tasks	Move multiple tasks	`tasks[]` with IDs or names, target list
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`
get_folder	Get folder details	`folderId`/`folderName`
update_folder	Update folder properties	`folderId`/`folderName`
delete_folder	Delete folder	`folderId`/`folderName`
get_list	Get list details	`listId`/`listName`
update_list	Update list properties	`listId`/`listName`
delete_list	Delete list	`listId`/`listName`
get_space_tags	Get space tags	`spaceId`/`spaceName`
create_space_tag	Create tag	`tagName`, `spaceId`/`spaceName`
update_space_tag	Update tag	`tagName`, `spaceId`/`spaceName`
delete_space_tag	Delete tag	`tagName`, `spaceId`/`spaceName`
add_tag_to_task	Add tag to task	`tagName`, `taskId`/(`taskName`+`listName`)
remove_tag_from_task	Remove tag from task	`tagName`, `taskId`/(`taskName`+`listName`)
get_task_time_entries	Get time entries for a task	`taskId`/`taskName`
start_time_tracking	Start time tracking on a task	`taskId`/`taskName`
stop_time_tracking	Stop current time tracking	None
add_time_entry	Add manual time entry to a task	`taskId`/`taskName`, `start`, `duration`
delete_time_entry	Delete a time entry	`timeEntryId`
get_current_time_entry	Get currently running timer	None
get_workspace_members	Get all workspace members	None
find_member_by_name	Find member by name or email	`nameOrEmail`
resolve_assignees	Resolve member names to IDs	`assignees[]`
create_document	Create a document	`workspaceId`, `name`, `parentId`/`parentType`, `visibility`, `create_pages`
get_document	Get a document	`workspaceId`/`documentId`
list_documents	List documents	`workspaceId`, `documentId`/`creator`/`deleted`/`archived`/`parent_id`/`parent_type`/`limit`/`next_cursor`
list_document_pages	List document pages	`documentId`/`documentName`
get_document_pages	Get document pages	`documentId`/`documentName`, `pageIds`
create_document_pages	Create a document page	`workspaceId`/`documentId`, `parent_page_id`/`name`/`sub_title`,`content`/`content_format`
update_document_page	Update a document page	`workspaceId`/`documentId`, `name`/`sub_title`,`content`/`content_edit_mode`/`content_format`

See full documentation for optional parameters and advanced usage.

Member Management Tools

When creating tasks, you can now assign users using the assignees parameter. The parameter accepts an array of user IDs, emails, or usernames:

{
  "name": "New Task",
  "description": "This is a new task.",
  "assignees": ["jdoe@example.com", "Jane Smith"]  // Emails, usernames, or user IDs
}

The member management tools help resolve user references when needed.

Prompts

Not yet implemented and not supported by all client apps. Request a feature for a Prompt implementation that would be most beneficial for your workflow (without it being too specific). Examples:

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

The LOG_LEVEL environment variable can be specified to control the verbosity of server logs. Valid values are trace, debug, info, warn, and error (default). This can be also be specified on the command line as, e.g. --env LOG_LEVEL=info.

Support the Developer

When using this server, you may occasionally see a small sponsor message with a link to this repository included in tool responses. I hope you can support the project! If you find this project useful, please consider supporting:

Acknowledgements

Special thanks to ClickUp for their excellent API and services that make this integration possible.

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.

Disclaimer

This software makes use of third-party APIs and may reference trademarks or brands owned by third parties. The use of such APIs or references does not imply any affiliation with or endorsement by the respective companies. All trademarks and brand names are the property of their respective owners. This project is an independent work and is not officially associated with or sponsored by any third-party company mentioned.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Enables AI integrations with ClickUp tasks, supporting resource management, task operations, workspace organization, and AI-powered task recommendations through a standardized protocol.

Related Resources

Reddit Discussion about this server

Related MCP Servers

ClickUp MCP Server
Nazruden
A
security
A
license
A
quality
This server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
5
56
7
TypeScript
MIT License
Browser Automation MCP Server
grapheneaffiliate
-
security
F
license
-
quality
Enables AI agents to control web browsers via a standardized interface for operations like launching, interacting with, and closing browsers.
Last updated -
0
JavaScript
ClickUp MCP Server
v4lheru
A
security
A
license
A
quality
An enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.
Last updated -
40
313
TypeScript
MIT License
Metabase MCP Server
imlewc
-
security
F
license
-
quality
Enables AI assistants to interact with Metabase databases and dashboards, allowing users to list and execute queries, access data visualizations, and interact with database resources through natural language.
Last updated -
9
JavaScript

View all related MCP servers

ClickUp MCP Server

Setup

Smithery Installation (Quick Start)

NPX Installation

Running with SSE Support

Docker-compose example

Features

Available Tools

Member Management Tools

Prompts

Error Handling

Support the Developer

Acknowledgements

Contributing

License

Disclaimer

Tools

Related Resources

Related MCP Servers

ClickUp MCP Server

Browser Automation MCP Server

ClickUp MCP Server

Metabase MCP Server

Appeared in Searches

New MCP Servers

MCP directory API