Search

Ask me anything

What is ClickUp MCP?

Your AI models and agents can use our official MCP (Model Context Protocol) server to access your ClickUp data in a simple and secure way. It's designed to work seamlessly with popular AI assistants like ChatGPT, Cursor, and Claude.

What you'll need

  • ClickUp MCP is available on all plans.
  • MCP usage and rate limits are subject to the terms of our fair use policy.
  • Future restrictions may apply to ClickUp MCP features.
  • ClickUp MCP usage and rate limits may change as we assess usage and costs.
  • You can set up the ClickUp MCP server with any app that supports MCP servers, like Claude, Cursor, or VS Code.

What can I do with the ClickUp MCP server?

  • Orchestrate task workflows: Create, enrich, and route tasks with assignees, Priorities, and due dates across Lists and Spaces.
  • Build executive reports: Produce release notes, status updates, and portfolio rollups consolidated from tasks, comments, and Docs.
  • Track time: Start and stop timers, log historical entries, and fetch entries.
  • Answer questions from work: Search tasks, Docs, and comments to deliver quick, context-rich answers.
  • Collaborate in comments and Chat: Summarize threads, extract action items, and post updates.

Available tools

ClickUp's MCP server enables AI assistants like ChatGPT, Claude, Cursor, or VS Code, to integrate with ClickUp's tools and data. This means your AI assistant can now execute actions, retrieve information, and provide intelligent, context-aware insights instantly.

For a full list of supported tools, read this developer article.

Example requests

Below are some examples of requests you could make after you've connected your AI assistant to ClickUp's MCP server:

  • Create a task for this bug we're working on.
  • Find all my incomplete tasks due this week.
  • List all milestones in the Product Launch project.
  • How many hours has the team spent on clients this month?

Setup instructions

For step-by-step setup instructions, read our MCP Server Setup Instructions article.

Rate limits

ClickUp's MCP Server has rate limits that depend on two criteria:

  1. If your Workspace has purchased the Everything AI add-on.
  2. Your Workspace plan.

With the Everything AI add-on

If your Workspace has purchased the Everything AI add-on, your MCP rate limits are the same as the rate limits for our Public API which vary by plan.
 

Without the Everything AI add-on

If your Workspace has not purchased the Everything AI add-on, your MCP usage is subject to the following rate limits by plan:

  • Free Forever Plan: 50 calls per 24 hours.
  • Unlimited Plan and above: 300 calls per 24 hours.

Rolling 24 hour rate limits

The rolling 24 hour rate limits begins with your first request.

For example, starting on Monday at 1pm, you use the MCP to send 200 requests.

On Tuesday, at 11am, you send another 100 requests.

You will be rate limited and unable to send additional requests via MCP until 1pm on Tuesday.

Attempting to send requests while rate limited does not extend the 24 hour limit.

Rate limits cannot be reset.

FAQ

Frequently asked questions about the ClickUp MCP server.

Can I authenticate with my own API keys or access tokens?

No, only OAuth is supported. OAuth is an industry-standard protocol that provides secure, delegated access. It lets you grant limited access to your resources without sharing credentials, supports granular permissions, and makes it easy to revoke access.

API keys are less secure because they’re static, usually have broad access, and are harder to manage or revoke if compromised.

Can I use ClickUp MCP to search external apps I've connected to my ClickUp Workspace?

No, Connected Search can only be used from within your Workspace. For a list of all external apps that support Connected Search, read our Connected Search article.

Do admins need to take any action inside ClickUp before setting up an external tool like Claude or ChatGPT?

No action is needed inside ClickUp. ClickUp MCP will provide the list of available tools.

Will my custom LLM connect?

Yes, if your team builds an MCP client implementation that meets the following criteria:

  • Implements the JSON-RPC 2.0 protocol over HTTP
  • Supports OAuth 2.1 with PKCE authentication
  • Follows the MCP specification