ClickUp MCP Server

How to use

You use an MCP-compatible client to connect to the ClickUp MCP Server. The server handles OAuth 2.0 authentication, issues a short-lived JWT session token, and then routes your requests to ClickUp through the MCP protocol. With a valid session, you can manage tasks, lists, folders, projects, time tracking, custom fields, and more—across both free and premium capabilities. Use natural language commands or structured tool calls from your AI assistant to perform actions like creating tasks, updating statuses, moving items, starting timers, and generating project views.

How to install

Prerequisites: you need Node.js and npm installed, plus Git for cloning repositories. You also need a modern web browser or an MCP client that can speak the MCP protocol over HTTP streamable transport.

Step 1 — Clone the MCP server repository.

git clone https://github.com/YOUR_GITHUB_USERNAME/clickup-remote-mcp-server.git
cd clickup-mcp-server

Step 2 — Install dependencies.

npm install

Step 3 — Run for CloudFlare Workers development.

npm run dev:worker

Step 4 — If you are developing a traditional MCP, build and start the server.

npm run build && npm start

Step 5 — Test and verify.

npm run test:ultrathink
npm test
npm run test:integration

Configuration and usage notes

The server supports two primary connection methods to integrate with clients: a remote HTTP MCP URL and a local standard MCP command setup. Choose the method that fits your workflow.

Security and optimization

OAuth 2.0 handles user authorization without exposing API keys. JWT sessions last 24 hours and can be refreshed via the /auth/refresh endpoint. All stored keys are encrypted at rest, and per-user isolation with audit logging helps protect your data. Global CloudFlare deployment provides low latency and high availability.

Troubleshooting

If you encounter issues, verify that your JWT is valid and not expired, ensure your API keys are stored securely via the provided endpoints, and check rate limits. For premium features, confirm your subscription status and that the correct tools are enabled for your tier.

create_task

Create a new task in ClickUp with specified title, description, due date, priority, and list/folder context.

get_task

Retrieve task details by ID, including status, assignees, and custom fields.

update_task

Update properties of an existing task such as status, title, due date, or assignees.

move_task

Move a task to a different list or folder within a workspace.

start_time_tracking

Start a time entry for a task to track work duration.

stop_time_tracking

Stop and save an active time entry for a task.

time_entries

List or query time entries for a given workspace or user.

custom_fields

Create, read, update, or delete custom fields for tasks and lists.

gantt

Generate and display Gantt charts for project timelines and dependencies.

milestones

Create and manage milestones within a project.

bulk_create_tasks

Create multiple tasks in a single operation.

bulk_update_tasks

Apply updates to a set of tasks in one operation.

bulk_move_tasks

Move multiple tasks to different lists or folders in one action.

comments

Add or retrieve comments on tasks.

view_hierarchy

Navigate and view the workspace hierarchy including spaces, folders, lists, and tasks.

get_members

Retrieve members of a workspace or specific list.

time_entries_report

Summarize time tracking data across tasks or projects.

dependencies

Create and manage dependencies between tasks.

attachments

Upload and attach files to tasks.

documents

Create and manage ClickUp documents linked to tasks or spaces.

spaces

Manage spaces with advanced settings and structure.

tags

Manage tag usage and organization across tasks.

project_management

Overview tools for milestones, templates, and project plans.