ClickUp MCP Server

Official ClickUp MCP server with 49 tools across tasks, bulk operations, comments, tags, time tracking, docs, and workspace hierarchy.

Collaboration by ClickUp OAuth2 active

Connect (Remote Server) Docs

Overview

ClickUp's official MCP server lets AI assistants read and write to a ClickUp Workspace over a single remote endpoint at https://mcp.clickup.com/mcp. Authentication is OAuth only (API keys and personal access tokens are not supported), so each client connects through ClickUp's OAuth flow and respects the user's existing Workspace permissions.

The server exposes around 49 tools that cover the full Workspace surface: task CRUD plus bulk create/update, custom fields, comments and threaded replies, tags, task links and dependencies, moving and sharing tasks across Lists, time tracking (start/stop timers, manual entries, time-in-status reporting), workspace hierarchy management (Spaces, Folders, Lists), member resolution, Chat channels and messages, and full Docs support (create, list pages, read, write, update).

ClickUp's MCP server is available on all plans, with rate limits that vary by tier. Free Workspaces are capped at 50 calls per rolling 24 hours, Unlimited+ plans get 300 calls per 24 hours, and Workspaces with the Everything AI add-on inherit the standard Public API rate limits.

Tools

Tool	Description
`Search Workspace`	Search tasks, Lists, Folders, and Docs across the entire Workspace.
`Search tasks by task type`	Retrieve tasks filtered by task type classification.
`Search tasks by tag`	Retrieve tasks filtered by tag labels.
`Create Task`	Create a new task in a specific List with assignees, priority, due date, and other fields.
`Get Task`	Retrieve the full details of a single task by ID.
`Update Task`	Modify task properties like status, assignees, or due dates.
`Set Custom Fields`	Apply custom field values to a task.
`Delete task`	Permanently remove a task or subtask.
`Create Bulk Tasks`	Create multiple tasks in a List in one call.
`Update Bulk Tasks`	Update many tasks at once (status, assignee, due date).
`Attach File to Task`	Upload and attach a file to a specific task.
`Get Task Comments`	Retrieve all comments on a task.
`Get Threaded Replies`	Retrieve threaded replies under a parent comment.
`Create Task Comment`	Add a comment to a task, including @mentions.
`Add Tag to Task`	Apply an existing tag to a task.
`Remove Tag from Task`	Remove a tag from a task.
`Add task link`	Link two tasks together.
`Remove task link`	Remove a link between two tasks.
`Add dependency`	Create a dependency relationship between tasks.
`Remove dependency`	Remove a dependency relationship.
`Move task to a new List`	Relocate a task to a different home List.
`Add task to another List`	Add a task to an additional List without moving it.
`Get Task Time Entries`	Retrieve all time entries logged on a task.
`Get time entries for multiple tasks`	Aggregate time entries across Lists, Folders, or Spaces.
`Start Time Tracking`	Start a timer for the current user on a task.
`Stop Time Tracking`	Stop the current user's active timer.
`Add Time Entry`	Manually log a block of time with start/end or duration.
`Get Current Time Entry`	Check whether the user has a running timer and return its details.
`Get Workspace Hierarchy`	Retrieve the full Workspace structure (Spaces, Folders, Lists).
`Create List`	Create a new List within a Folder or Space.
`Create List in Folder`	Create a List specifically inside a Folder.
`Get List`	Retrieve the details and settings of a List.
`Update List`	Modify List settings like name or color.
`Get Folder`	Retrieve a Folder and the Lists it contains.
`Create Folder`	Create a new Folder within a Space.
`Update Folder`	Rename or modify Folder settings.
`Get Workspace Members`	List all members and guests in the Workspace.
`Find Member by Name`	Locate a Workspace member by name or email.
`Resolve Assignees`	Resolve user objects for assignee lists before assigning.
`Get Chat Channels`	List all Chat channels (views) in the Workspace.
`Send Chat Message`	Send a message to a specific Chat channel.
`Create Document`	Create a new Doc in a Workspace location.
`List Document Pages`	Retrieve the table of contents (pages) of a Doc.
`Get Document Pages`	Read the content of one or more Doc pages.
`Create Document Page`	Add a new page or sub-page to an existing Doc.
`Update Document Page`	Edit the content of an existing Doc page.
`Get Time in Status for a task`	Measure how long a task has spent in each status.
`Get Time in Status for tasks in a List`	Aggregate time-in-status metrics across tasks in a List.

Setup Guide

ClickUp hosts the MCP server itself. There is nothing to install or self-host. Point your MCP client at https://mcp.clickup.com/mcp and complete the OAuth flow when prompted.

Prerequisites

A ClickUp Workspace (any plan)
OAuth login when the client first connects (API keys are not accepted)

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clickup.com/mcp"]
    }
  }
}

Cursor (mcp.json):

{
  "mcpServers": {
    "clickup": {
      "url": "https://mcp.clickup.com/mcp"
    }
  }
}

VS Code (one-shot CLI):

code --add-mcp '{"type":"http","name":"clickup","url":"https://mcp.clickup.com/mcp"}'

Then open the MCP servers panel in VS Code, click the settings cog on the ClickUp entry, and start the server to trigger the OAuth flow.

Generic MCP clients:

Command: npx
Arguments: -y mcp-remote https://mcp.clickup.com/mcp
Environment: none

After the first request, your browser will open to ClickUp for OAuth consent. Approve the Workspace(s) you want the assistant to access.

Use Cases

Triage inbound work: search the Workspace for new tasks, apply tags, set priority and due date, and assign the right teammate via Find Member by Name and Resolve Assignees.
Bulk reorganize sprints by moving tasks between Lists, adding dependencies, and using Update Bulk Tasks to shift statuses or due dates after a planning meeting.
Track time inside the chat loop: start/stop timers, log manual entries, and pull Time in Status reports to surface bottlenecks in a workflow.
Generate executive updates by reading Docs pages, task comments, and time entries, then writing the summary back as a new Doc page or task comment.
Operate Chat from the assistant: list channels and post status updates, release notes, or @mentions to relevant teams.

Example Prompts

"Create 12 tasks in the 'Q3 Launch' List from this spec, assign them to Priya, and set due dates one week apart."
"Find every open task tagged 'bug' in the Mobile Space and bump priority to Urgent."
"Start a timer on task ABC-123, and tell me what's currently running for me."
"Summarize the last 7 days of comments on the 'Onboarding revamp' task and post the summary as a new page in the Product Doc."
"Show me time-in-status for every task in the 'In QA' List and flag anything stuck more than 3 days."

Pros

Official, provider-hosted server with a stable remote URL, no self-hosting or key management required.
Broad coverage: tasks, bulk ops, comments, tags, dependencies, time tracking, Docs, Chat, and workspace hierarchy in one server.
OAuth-based auth respects ClickUp's existing permissions model per user and Workspace.
Available on all ClickUp plans.

Limitations

Tight rate limits without the Everything AI add-on: 50 calls per 24 hours on Free and 300 on Unlimited+ in a rolling window that cannot be reset.
OAuth is the only supported auth method; API keys and personal tokens are rejected, which complicates fully headless or server-to-server setups.
Custom MCP clients must meet ClickUp's spec requirements and be submitted for review before connecting.

Alternatives

taazkareem/clickup-mcp-server: community ClickUp MCP server that uses a personal API token, useful if you cannot use OAuth.
hauptsacheNet/clickup-mcp: another open-source ClickUp MCP implementation.
Linear, Asana, or Jira MCP servers if you are evaluating non-ClickUp project management options.