Skip to main content
Glama

ClickUp MCP Server

by windalfin

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.

🚧 Status Update: -The code refactoring has been completed. -Enhanced due date functionality now supports relative time expressions like "2 hours from now" with proper time display in ClickUp. -npx command updated to use @latest which should automatically update the server when a new version is released. -Server has been listed on Smithery, Glama, and Pulse MCP.

Quick Start

Directions for use with Cursor Composer Agent:

  1. Get your credentials:

  2. Go to Features in settings (or MCP Servers depending on version)

  3. Add under MCP Servers:

npx -y @taazkareem/clickup-mcp-server@latest \ --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!

Smithery Installation

smithery badge

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

Features

  • 🎯 Task Management

    • Create, update, and delete individual tasks

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

    • Create, update, move,and delete multiple tasks in bulk

    • View and modify task details and properties

    • Set due dates using natural language and relative time expressions

  • 📂 Workspace Organization

    • Complete workspace hierarchy (spaces, folders, lists)

    • Tree structure with clear relationships

    • Full CRUD operations for workspace components

    • Efficient path-based navigation

  • 🔄 Integration Features

    • Name or ID-based item lookup

    • Case-insensitive name matching

    • Markdown formatting support

    • Built-in API rate limiting

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 task details

taskId

/

taskName

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

See full documentation for optional parameters and advanced usage.

Available Prompts

Not yet implemented (or needed) For now, you can send a follow up prompt after the tool result.

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

Support the Developer

If you find this project useful, please consider supporting

Sponsor TaazKareem

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

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.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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.

  1. Quick Start
    1. Smithery Installation
      1. Features
        1. Available Tools
          1. Available Prompts
            1. Error Handling
              1. Support the Developer
                1. Contributing
                  1. License
                    1. Disclaimer

                      Related MCP Servers

                      • 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
                      • A
                        security
                        A
                        license
                        A
                        quality
                        ClickUp MCP Server enables AI assistants to seamlessly interact with your ClickUp workspace. This powerful integration allows Claude to create and manage tasks, access documents, organize folders and lists, add comments, and handle checklists—all through natural conversation.
                        Last updated -
                        42
                        46
                        36
                        MIT License
                        • Apple
                      • -
                        security
                        A
                        license
                        -
                        quality
                        A Model Context Protocol server that enables Large Language Models to interact with ClickUp workspace tasks and data, allowing creation and retrieval of tasks through natural language.
                        Last updated -
                        19
                        46
                        3
                        MIT License
                        • Apple
                      • A
                        security
                        F
                        license
                        A
                        quality
                        A Model Context Protocol server that enables AI agents to generate, fetch, and manage UI components through natural language interactions.
                        Last updated -
                        3
                        21
                        6

                      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/windalfin/clickup-mcp-server'

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