Skip to main content
Glama

ClickUp MCP Server

Total Supporters GitHub Stars Maintenance

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

  1. Get your credentials:

  2. Choose either hosted installation (sends webhooks) or NPX installation (downloads to local path and installs dependencies)

  3. Use natural language to manage your workspace!

Smithery Installation (Quick Start)

smithery badge

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

NPM Version Dependency Status NPM Downloads

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:

Sponsor TaazKareem

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

License: MIT

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.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

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

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

  1. Smithery Installation (Quick Start)
    1. NPX Installation
      1. Running with SSE Support
        1. Docker-compose example
          1. Features
            1. Available Tools
              1. Member Management Tools
                1. Prompts
                  1. Error Handling
                    1. Support the Developer
                      1. Acknowledgements
                        1. Contributing
                          1. License
                            1. Disclaimer

                              Related MCP Servers

                              • 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 -
                                14
                                14
                                MIT License
                                • Apple
                              • 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 -
                                0
                                2
                                MIT License
                              • -
                                security
                                A
                                license
                                -
                                quality
                                A Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.
                                Last updated -
                                1,703
                                2
                                MIT License
                              • A
                                security
                                A
                                license
                                A
                                quality
                                Enables AI assistants to interact with ClickUp's task management API for core project workflows, supporting operations like task creation, updates, search, assignment, and team analytics through natural language.
                                Last updated -
                                28
                                3
                                MIT License
                                • Apple
                                • Linux

                              View all related MCP servers

                              MCP directory API

                              We provide all the information about MCP servers via our MCP API.

                              curl -X GET 'https://glama.ai/api/mcp/v1/servers/taazkareem/clickup-mcp-server'

                              If you have feedback or need assistance with the MCP directory API, please join our Discord server