ClickUp MCP server
ClickUp's official remote MCP server lets agents manage tasks, lists, folders, docs, time tracking, and chat across a workspace.
The ClickUp MCP Server is the official first-party remote server from ClickUp that lets an AI agent operate on your workspace through natural language. It covers the full hierarchy: creating and updating tasks (singly or in bulk) with assignees, priorities, due dates, custom fields, tags, dependencies, and links; navigating spaces, folders, and lists and creating new ones; and reading and writing task comments and threaded replies. Beyond tasks it handles Docs (create documents and pages, list and read pages, edit content), time tracking (start and stop timers, add manual entries, read entries and what is currently running), reporting (time-in-status for a task or a whole list), chat (list channels and send messages), and a universal search across tasks, lists, folders, and docs. Members and assignees can be looked up and resolved by name or email so the agent assigns work to the right people.
The server is hosted and remote at https://mcp.clickup.com/mcp and supports OAuth only, you cannot use a personal API key, which keeps every action tied to an authenticated ClickUp identity with its existing permissions. It is currently in public beta and available on all plans, and works with an allowlist of vetted MCP clients (Claude Code, Claude Desktop, Cursor, VS Code, ChatGPT, and more). Destructive deletion of higher-level objects is intentionally limited during the beta as a safety measure.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"clickup": {
"type": "http",
"url": "https://mcp.clickup.com/mcp"
}
}
}claude mcp add --transport http clickup https://mcp.clickup.com/mcpHeads up
- First tool call opens a browser to authorize.
Available tools
| Tool | Description |
|---|---|
| search_workspace | Searches for items across the entire workspace, including tasks, lists, folders, and docs. |
| search_tasks_by_task_type | Retrieves tasks filtered by task type. |
| search_tasks_by_tag | Retrieves tasks filtered by tags. |
| create_task | Creates a new task in a specific list with name, description, assignees, due date, and priority. |
| get_task | Retrieves the full details of a single task by its task ID. |
| update_task | Modifies an existing task's name, description, status, assignees, or due date. |
| set_custom_fields | Sets custom field values on a task. |
| delete_task | Deletes a task or subtask. |
| create_bulk_tasks | Creates multiple tasks in a specified list in a single call. |
| update_bulk_tasks | Modifies multiple tasks at once. |
| attach_file_to_task | Uploads and attaches a file to a specific task. |
| get_task_comments | Retrieves all comments on a specific task. |
| get_threaded_replies | Retrieves threaded replies under a parent task comment. |
| create_task_comment | Adds a new comment to a task. |
| add_tag_to_task | Applies an existing tag to a task. |
| remove_tag_from_task | Removes a tag from a task. |
| add_task_link | Relates two tasks by linking them. |
| remove_task_link | Removes a link between tasks. |
| add_dependency | Creates a dependency relationship between tasks. |
| remove_dependency | Removes a dependency relationship between tasks. |
| move_task_to_list | Moves a task to a new home list. |
| add_task_to_list | Adds a task to an additional list. |
| get_task_time_entries | Retrieves all time-log entries for a specific task. |
| get_time_entries_for_tasks | Retrieves total time entries for tasks in a space, folder, or list. |
| start_time_tracking | Starts a timer for a specific task. |
| stop_time_tracking | Stops the currently active timer. |
| add_time_entry | Manually adds a block of time to a task. |
| get_current_time_entry | Checks whether the user has a timer currently running. |
| get_workspace_hierarchy | Retrieves the full workspace structure of spaces, folders, and lists. |
| create_list | Creates a new list within a space or folder. |
| create_list_in_folder | Creates a new list inside a designated folder. |
| get_list | Retrieves the details and settings of a single list. |
| update_list | Modifies the settings of an existing list. |
| get_folder | Retrieves the details of a single folder. |
| create_folder | Creates a new folder within a space. |
| update_folder | Modifies the settings of an existing folder. |
| get_workspace_members | Retrieves all members and guests in the workspace. |
| find_member_by_name | Searches for a workspace member by name or email. |
| resolve_assignees | Confirms and retrieves user objects for a list of potential assignees. |
| get_chat_channels | Retrieves a list of all chat channels in the workspace. |
| send_chat_message | Sends a message to a specific chat channel. |
| create_document | Creates a new doc in the workspace. |
| list_document_pages | Retrieves the structure or table of contents of a doc. |
| get_document_pages | Retrieves the content of one or more pages from a doc. |
| create_document_page | Adds a new page to an existing doc. |
| update_document_page | Edits the content of an existing doc page. |
| get_time_in_status_for_task | Retrieves how long a task has spent in each status. |
| get_time_in_status_for_list | Retrieves time-in-status metrics for the tasks in a list. |
What you can do with it
Run a project from chat
The agent reads the workspace hierarchy, creates tasks in the right list with assignees and due dates, links dependencies, and posts a status comment, all from a natural-language brief.
Roll up a status report
Using search, time-in-status, and time-tracking tools, the agent assembles a portfolio summary or release note from the tasks and docs already in the workspace.
FAQ
- Is it free?
- Yes. The ClickUp MCP server is in public beta and available on all plans at no extra charge; it operates within your existing ClickUp workspace and plan limits.
- Does it support remote/OAuth?
- Yes, and only OAuth. The server is hosted and remote at https://mcp.clickup.com/mcp; you cannot authenticate with a personal API key or auth token, which ties every action to an authenticated ClickUp identity.
- Can it delete things in my workspace?
- Task deletion is supported, but ClickUp intentionally limits destructive deletion of higher-level objects during the public beta as a safety measure.