ClickUp MCP Server

by taazkareem
Verified

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.

Integrations

  • Allows AI agents to interact with ClickUp tasks, spaces, lists, and folders, including creating, updating, deleting, moving and duplicating tasks, as well as managing workspace organization through a standardized Model Context Protocol (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: v0.5.2 release with new Attach Task Files tool, Create Task Comments tool, Get Task Comments tool, Custom ID support across all tools, and Subtasks support.

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)

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" } } } }

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

Features

  • 🎯 Task Management
    • Create, retrieve, update, and delete tasks
    • Move and duplicate tasks between lists, spaces, and folders
    • Single operation or bulk operation
    • View and modify task details and properties
    • Get task comments
    • Set due dates using natural language and relative time expressions
    • Attach files to tasks using local file paths, URL, base64, or chunked uploads
    • Create and manage subtasks with support for multi-level nesting
  • 📂 Workspace Organization
    • Complete workspace hierarchy (spaces, folders, lists)
    • Tree structure with clear relationships
    • 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

ToolDescriptionRequired Parameters
get_workspace_hierarchyGet workspace structureNone
create_taskCreate a taskname, (listId/listName), optional parent
create_bulk_tasksCreate multiple taskstasks[]
update_taskModify tasktaskId/taskName
update_bulk_tasksUpdate multiple taskstasks[] with IDs or names
get_tasksGet tasks from listlistId/listName, optional subtasks
get_taskGet task detailstaskId/taskName, optional subtasks
get_task_commentsGet comments on a tasktaskId/taskName
create_task_commentAdd a comment to a taskcommentText, (taskId/(taskName+listName))
attach_task_fileAttach file to a tasktaskId/taskName, (file_data or file_url)
delete_taskRemove tasktaskId/taskName
delete_bulk_tasksRemove multiple taskstasks[] with IDs or names
move_taskMove tasktaskId/taskName, listId/listName
move_bulk_tasksMove multiple taskstasks[] with IDs or names, target list
duplicate_taskCopy tasktaskId/taskName, listId/listName
create_listCreate list in spacename, spaceId/spaceName
create_folderCreate foldername, spaceId/spaceName
create_list_in_folderCreate list in foldername, folderId/folderName
get_folderGet folder detailsfolderId/folderName
update_folderUpdate folder propertiesfolderId/folderName
delete_folderDelete folderfolderId/folderName
get_listGet list detailslistId/listName
update_listUpdate list propertieslistId/listName
delete_listDelete listlistId/listName

See full documentation for optional parameters and advanced usage.

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:

PromptPurposeFeatures
summarize_tasksTask overviewStatus summary, priorities, relationships
analyze_prioritiesPriority optimizationDistribution analysis, sequencing
generate_descriptionTask description creationObjectives, 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.

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

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. Features
        1. Available Tools
          1. Prompts
            1. Error Handling
              1. Support the Developer
                1. Acknowledgements
                  1. Contributing
                    1. License
                      1. Disclaimer