How to connect Claude Code to ClickUp

Paste a ClickUp personal API token into Ryze AI once, register one MCP address with claude mcp add, then read tasks, lists and comments from your terminal.

Your MCP URL
https://connector.get-ryze.ai/mcp

Paste it into claude mcp add --transport http ryze. See the steps

See pricing

By Ira Bodnar, Ryze AI · Updated · Connector tested November 18, 2026

Quick answer

The main way to connect Claude Code to ClickUp is the Ryze AI connector. Paste a ClickUp personal API token into the ClickUp card in Ryze AI and pick one ClickUp Workspace, register the server in your shell with claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp, then type /mcp in Claude Code, pick ryze and sign in. A fresh session can then read and update your tasks.

  1. In ClickUp open Settings > Apps > API Token and click Generate
  2. In Ryze AI open Integrations, click Connect on the ClickUp card, paste the pk_ token and choose the Workspace
  3. In a shell, outside any Claude Code session, run the claude mcp add command, then type /mcp and pick Authenticate
  4. Tick the Ryze AI workspace, click Allow connection and ask a ClickUp question

Claude Code to ClickUp at a glance

FactDetail
Main way to connectThe Ryze AI connector, a hosted MCP server that Claude Code registers with one claude mcp add command
Server addresshttps://connector.get-ryze.ai/mcp, added with the HTTP transport
Sign-inA ClickUp personal API token (starts with pk_) pasted into Ryze AI once, then the Ryze AI page that /mcp or claude mcp login ryze opens. Unattended runs can send a Ryze AI API key in an Authorization header instead
ClickUp tools3: clickup__read, clickup__write and clickup__delete
Can Claude Code change ClickUpYes. clickup__write creates and updates tasks and adds comments, and clickup__delete removes a task or comment. Ask rules on those two tools make Claude Code stop before each change
Same chat, other dataThe same address serves the other platforms connected in your Ryze AI workspace
Claude Code planPro, Max, Ultra, Team, Enterprise or Console. The free claude.ai plan does not include Claude Code
ClickUp access you needAny ClickUp user who can open Settings > Apps and generate a personal token. The agent sees what that user sees
Ryze AI pricePaid Ads is $89 per month with a 7-day free trial. Adding the connector costs nothing
ClickUp's own option for Claude CodeClickUp's MCP server at https://mcp.clickup.com/mcp, OAuth only, on all ClickUp plans. A community server also gives a Claude Code command
Last testedConnector address and sign-in details on November 18, 2026. No ClickUp call and no step inside Claude Code was run

Before you start

  • A Claude Code account. Anthropic's setup page lists Pro, Max, Ultra, Team, Enterprise and Console accounts, and the free claude.ai plan does not include Claude Code. A third-party provider works as well: Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry. Anthropic's MCP page asks for no further plan before you add a remote server.
  • A ClickUp personal API token. In ClickUp open Settings > Apps, find API Token and click Generate. The token starts with pk_, and ClickUp says personal tokens never expire. The Ryze AI agent acts as the token owner, so generate it from the ClickUp login whose reach you are comfortable sharing.
  • An active Ryze AI plan or trial. Paid Ads is $89 per month and comes with a 7-day free trial. SEO Starter is $129 per month with a 3-day free trial, and Agency is $279 per month. The connector is free to add, yet the ClickUp tools only answer while a plan or trial is active.

How to connect Claude Code to ClickUp

The first three steps happen in ClickUp and Ryze AI, the next two in your terminal, and the last in the browser and your first session. Every user registers the same connector address.

  1. Generate a ClickUp personal API token

    In ClickUp open Settings > Apps, find API Token and click Generate. Copy the token, which starts with pk_.

  2. Connect ClickUp in Ryze AI

    Sign in to Ryze AI or create an account, open Integrations and click Connect on the ClickUp card. Paste the token into Personal API token and click Continue.

  3. Choose the ClickUp Workspace

    Pick the Workspace the agent reads and writes and click Save. If you belong to only one Workspace, Ryze AI picks it for you. One connection covers one ClickUp Workspace.

  4. Register the connector in Claude Code

    In a terminal, outside any running claude session, enter claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp. The name ryze is your own choice, and Claude Code uses it to label the server's tools. With no scope flag the entry stays local to the current project; --scope user makes it available in all of them. Claude Code confirms with an Added HTTP MCP server line.

  5. Sign in from Claude Code

    Start Claude Code and type /mcp. Select ryze, press Enter and choose Authenticate. From the shell, claude mcp login ryze runs the same sign-in; with --no-browser it prints the link and waits for you to paste the redirect address back, which suits an SSH session opened with ssh -t.

  6. Allow the workspace and ask your first question

    A Ryze AI page opens in the browser. Sign in if it asks, tick the workspace that holds your ClickUp connection and click Allow connection. Back in the shell, claude mcp get ryze reports whether the server is connected. Open a new session and try: List the tasks assigned to me in ClickUp that are past their due date.

The Ryze AI ClickUp guide covers the ClickUp side of the connection, and the Claude Code MCP docs cover the commands in the terminal.

Sources: Claude Code MCP, Claude Code MCP quickstart, Claude Code setup, Ryze AI ClickUp guide, ClickUp authentication. Checked November 18, 2026.

OAuth, API key and claude.ai connectors

Claude Code takes the Ryze AI connector in three ways. Choose by where the session runs and who signs in.

Terminal sign-in with OAuth

claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user

This is the route for your own machine. The scope sets where the entry lives. Local, the default, keeps it in ~/.claude.json for the current project only. User stores it in ~/.claude.json for every project. Project writes .mcp.json into the repository, so teammates get it through version control and each approves it once in an interactive session. A scope cannot be edited later: remove the entry and add it again under the new one. In a shared project, remember that the ClickUp token behind the connector belongs to whoever pasted it into Ryze AI.

Terminal with a Ryze AI API key

claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --header "Authorization: Bearer rk_live_..."

Make the key in Ryze AI under Workspace Settings, Profile, API keys, Create key, and copy it right away, because it is shown once. The Ryze AI help center says keys work at /mcp and not at /sse. If the server rejects a configured Authorization header, Claude Code reports the connection as failed and does not switch to OAuth, so replace the key or drop the header. Keep the key out of repositories and shared shell history.

Connectors from your claude.ai account

Add Ryze AI on claude.ai under Customize, Connectors and finish its sign-in there. Then log in to Claude Code with that claude.ai subscription and open /mcp, where the connector carries a marker showing it came from claude.ai. On Team and Enterprise only admins can add servers in claude.ai. Claude Code loads these connectors only under a claude.ai subscription login, so sessions running on ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, apiKeyHelper or a third-party provider go without them; /status names the active login.

Scripts and limits

claude -p and Agent SDK runs have no /mcp panel and cannot finish a browser sign-in. Sign in beforehand from an interactive session with /mcp or claude mcp login ryze, or give the server a Ryze AI API key. Claude Code warns when a tool result passes 10,000 tokens and limits output to 25,000 tokens by default; the MAX_MCP_OUTPUT_TOKENS variable changes that limit, so a long task list may need a narrower question. A call to an HTTP server that sends no response or progress for five minutes is aborted.

Claude Code and MCP in one table

TopicWhat Anthropic's Claude Code docs say
Config files~/.claude.json keeps local entries under the current project and user entries under its top-level mcpServers key. Project entries live in .mcp.json at the project root. Paths such as ~/.claude/mcp.json are never read
TransportsHTTP, the recommended one for remote servers; SSE, deprecated; stdio for a local process; WebSocket in JSON config only
Sign-inOAuth 2.0. A server that answers 401 or 403 is marked as needing authentication, and Claude Code follows a WWW-Authenticate header on its own
Static credentials--header (short form -H) when adding, a headers object in JSON, or a headersHelper command that prints headers at connect time
Tool approvalFrom version 2.1.283, interactive sessions start in auto mode when the model and settings allow it. Rules set in /permissions are checked deny first, then ask, then allow. claude -p and Agent SDK runs without a mode start in Manual mode
Tool loadingTool search is on by default, so MCP tools are deferred and loaded when a task needs them
Where servers are managedclaude mcp list, get, remove, login and logout in the shell; /mcp inside a session to authenticate, reconnect or switch a server off
PlanPro, Max, Ultra, Team, Enterprise or Console. The MCP page adds no plan for remote servers
Admin controlsAdmins can ship managed-mcp.json, hand servers to everyone with managedMcpServers, or filter with allowedMcpServers and deniedMcpServers. A server stopped this way shows Blocked by enterprise managed policy

Sources: Claude Code MCP, Claude Code permission modes, Claude Code permissions, Claude Code managed MCP, Claude Code cloud environments, Ryze AI in the Anthropic Directory. Checked November 18, 2026.

Claude web, ChatGPT and Cursor

Other MCP clients take the same address. ClickUp stays connected once in Ryze AI, so nothing changes on the ClickUp side.

Claude on the web and Desktop

In Customize, Connectors choose Add, then Add custom connector, call it Ryze AI and paste https://connector.get-ryze.ai/mcp. The same connector then turns up in Claude Code when Claude Code runs on that subscription login. The Claude guide for ClickUp has every click.

ChatGPT

OpenAI gives full custom MCP server support to Business and Enterprise/Edu workspaces on the web, and read and fetch permissions only to Pro. Add the address as an app under Settings > Apps with OAuth. The ChatGPT guide for ClickUp walks through it.

Cursor

Put the entry below in ~/.cursor/mcp.json for all projects or in .cursor/mcp.json for one. Cursor runs the OAuth sign-in, so sign in on the Ryze AI page and click Allow connection.

{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }

ClickUp token and permissions

ClickUp has no scope picker for a personal token, so three things decide what Claude Code can see and change.

Whose access
The ClickUp user who generated the token. The Ryze AI notes say the agent acts as the token owner and sees and edits what that user can.
Which Workspace
The one Workspace you pick on the ClickUp card. One connection covers one ClickUp Workspace, and the help center does not list ClickUp among the platforms that support several accounts.
What Claude Code asks first
That depends on your rules. Add ask rules for the write and delete tools in /permissions and Claude Code stops before each change. Without them, the permission mode decides.

What the Ryze AI connection can reach

ClickUp's authentication page lists no granular permissions for a personal token and says personal tokens never expire. The table lists what Ryze AI documents for the connection.

AccessWhat it coversThrough which tool
ReadWorkspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docsclickup__read
Create and updateCreating a task, updating a task and adding a commentclickup__write
DeleteDeleting a task or a comment by pathclickup__delete

Not included: a second Workspace on the same connection, and writes to Docs. Ryze AI's help page says documented writes cover tasks and comments only, and its intro line about editing lists, spaces and docs is wider than that list, so this guide claims only task creation, task updates and comments as writes. The token also reaches only what its owner can reach in ClickUp, so a private List the owner cannot open stays closed to Claude Code.

Regenerating the token in ClickUp makes the old one stop working, and the ClickUp card in Ryze AI then needs the new one.

Sources: Ryze AI ClickUp guide, ClickUp authentication. Checked November 18, 2026.

Removing access

In Claude Code, run claude mcp logout ryze to clear the stored sign-in, or claude mcp remove ryze to delete the entry. On the ClickUp side, clicking Regenerate under Settings > Apps > API Token replaces the token. The Ryze AI notes used for this guide give no disconnect step for the ClickUp card, so this guide does not describe one.

What Claude Code can do in ClickUp

The Ryze AI connector exposes three ClickUp tools: one read, one write and one delete. The list comes from Ryze AI's integration manifest and has not yet been seen live in a connected workspace. In Claude Code they appear as mcp__ryze__clickup__read, mcp__ryze__clickup__write and mcp__ryze__clickup__delete when the server is named ryze.

ToolTypeWhat it does
clickup__readReadReads ClickUp data with GET requests: Workspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docs.
clickup__writeWriteCreates or updates ClickUp objects with POST or PUT, such as creating a task, adding a comment or updating a task.
clickup__deleteDeleteDeletes a ClickUp object by path, such as a task or a comment.

Claude Code decides call by call whether to ask you. Interactive sessions on version 2.1.283 or later start in auto mode when the session supports it: a call that matches an allow, ask or deny rule follows that rule, and other MCP calls go to a second model, the classifier, instead of to you. To be asked before every ClickUp change, add ask rules for mcp__ryze__clickup__write and mcp__ryze__clickup__delete in /permissions. In claude -p and Agent SDK runs, a call that needs approval is denied unless a rule or hook allows it. The Ryze AI chat has a separate Tool approvals setting that starts on Skip all approvals; pick Approve write & delete or Manual approve there. Ryze AI scheduled tasks have no approval step. On claude.ai, Customize, Connectors, Ryze AI, Tool permissions can mark write and delete tools as Needs approval.

Limits in numbers

LimitNumberSource
ClickUp API requests per minute, Free Forever, Unlimited and Business100 per tokenClickUp rate limits
ClickUp API requests per minute, Business Plus1,000 per tokenClickUp rate limits
ClickUp API requests per minute, Enterprise and Enterprise Plus10,000 per tokenClickUp rate limits
When the ClickUp limit is exceededHTTP 429 from the ClickUp APIClickUp rate limits
Ryze AI notes on the ClickUp limit100 requests per minute per tokenRyze AI ClickUp guide
ClickUp connections per Ryze AI connection1 WorkspaceRyze AI ClickUp guide
Claude Code tool result warning10,000 tokensClaude Code MCP
Claude Code tool result default limit25,000 tokens, changed with MAX_MCP_OUTPUT_TOKENSClaude Code MCP
Claude Code idle time per HTTP tool call5 minutes without a response or progressClaude Code MCP
ClickUp's own MCP server, per connection1,000 requests per minute, shown for comparisonClickUp MCP tools
ClickUp's own MCP server, per dayWithout the Everything AI add-on, per Workspace and per client in a rolling 24 hours: 100 on Free Forever, 300 on Core and Unlimited, 1,000 on Business, 2,500 on Business Plus, 5,000 on Enterprise, 25,000 on Enterprise PlusConnect an AI assistant

ClickUp's rate limit page names the plan Unlimited while its MCP page lists Core/Unlimited; this guide repeats each page's wording. The daily MCP limits belong to ClickUp's own server. Whether the Ryze AI connector's calls count against them is not stated by either vendor.

Sources: ClickUp rate limits, ClickUp MCP tools, ClickUp MCP setup page, Claude Code MCP, Ryze AI ClickUp guide. Checked November 18, 2026.

First 3 prompts to run

Name the Space, Folder or List when you can, and ask for the fields you want back. Each answer comes from your own Workspace, so this page describes what comes back instead of showing sample task data.

1. Find overdue tasks

In my ClickUp Workspace, list the tasks assigned to me that are past their due date. Show each task name, its List and its due date.

Tools used: clickup__read

What comes back: A list of task names with their Lists and due dates. Nothing is changed.

2. Summarize the comments on a task

Read the comments on the ClickUp task I name next and summarize who asked for what, in the order it happened.

Tools used: clickup__read

What comes back: A written summary of that task's comment thread, built from the comments the read tool returns.

3. Create a task and add a comment

Create a task called Draft Q1 report in the List named Reporting, then add a comment on it that says the outline is due Friday.

Tools used: clickup__write

What comes back: A new task in that List and a comment on it. If you set an ask rule on the write tool, Claude Code stops and waits for your approval first.

Replace the names with your own. Deleting has its own tool, so name the task and say that you want it deleted.

10 jobs to hand to Claude Code

Ten jobs to hand to Claude Code in ClickUp, with the tool each one calls. None was run for this guide, since no ClickUp Workspace was connected. A Yes means a Ryze AI tool covers the job according to Ryze AI's notes. The No row is a job the documented tools do not cover.

JobAsk Claude CodeToolDefault connection
Workspace mapList my Spaces, Folders and Lists.clickup__readYes
Overdue tasksWhich tasks assigned to me are past their due date?clickup__readYes
Task detailShow the description, assignees and custom fields of the task I name.clickup__readYes
Comment threadSummarize the comments on a task.clickup__readYes
Team listList the members of the Workspace.clickup__readYes
Read a DocFind the Doc I name and summarize it.clickup__readYes
Create a taskCreate a task with this name in this List.clickup__writeYes, and an ask rule makes Claude Code stop first
Update a taskUpdate the task I name with this change.clickup__writeYes, and an ask rule makes Claude Code stop first
Remove a taskDelete the task I name.clickup__deleteYes, only when you ask, and add an ask rule first
Edit a DocRewrite this Doc.noneNo. Ryze AI documents Docs as read only

3 ways to connect Claude Code to ClickUp

Three ways reach ClickUp from Claude Code, counting only those whose makers name Claude Code or accept any MCP client. This guide uses the first, the Ryze AI connector, as the main way: ClickUp is linked once with a token in Ryze AI, Claude Code gets a single claude mcp add command, and reads, writes and deletes stay in separate tools. The other two were read on their own pages on November 18, 2026, and neither was installed for this guide.

WayRuns whereSetup in Claude CodeWhat it reaches in ClickUpPrice
Ryze AI connector (the main way)Hosted by Ryze AI, one address for every userclaude mcp add --transport http ryze https://connector.get-ryze.ai/mcp, then Authenticate in /mcp. A Ryze AI API key passed with --header, or the connector from your claude.ai account, work too3 tools: read Workspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docs; create and update tasks and add comments; delete a task or comment. One Workspace per connectionPaid Ads is $89 per month with a 7-day free trial. The connector is free to add
ClickUp's MCP serverHosted by ClickUp at https://mcp.clickup.com/mcpClickUp's page says it supports all major MCP clients and gives no Claude Code command. Anthropic's syntax, claude mcp add --transport http clickup https://mcp.clickup.com/mcp followed by Authenticate in /mcp, should apply, but it was not run. ClickUp says OAuth only, so a personal API token cannot be usedClickUp's tools page lists categories such as tasks, time tracking, comments, Docs, chat and reminders, with calls running under the signed-in user's permissions. Its FAQ says no deletion tools were added as a safety measure, while the tools page lists Delete taskClickUp says it is available on all plans, with daily call limits by plan
taazkareem/clickup-mcp-server, communityHosted at https://clickup-mcp.taazkareem.com/mcp, or self-hostedIts README gives claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp with an X-License-Key headerThe README counts 150 toolsProprietary license: $9 per month, $59 per year or $89 lifetime, per its README

Options that do not fit this client

  • ClickUp's directory connectors in Claude. ClickUp's own connector can be added in claude.ai, and Anthropic's docs say connectors on your claude.ai account load into Claude Code under a claude.ai subscription login. That route was not tried with ClickUp's connector for this guide.
  • A personal API token on ClickUp's own server. ClickUp's MCP page says you cannot authenticate with your own API keys or access tokens. The Ryze AI connector is the route that uses a personal token, because Ryze AI holds it and Claude Code signs in to Ryze AI.
  • Local config servers that need your machine. Claude Code can run stdio servers as local processes, but none of the pages read for this guide gives a ClickUp command of that kind for Claude Code.

Which one to pick

Ryze AI is the best way to connect Claude Code to ClickUp when you want one claude mcp add command, ClickUp linked with a token you control, and deletes kept in their own tool, with one caveat: it has three tools, one ClickUp Workspace per connection, and Docs are read only. ClickUp's own server needs no Ryze AI plan, signs in with OAuth and lists more areas, including time tracking, chat and reminders, so it is the better fit when Claude Code is your only assistant and you need those. The community server suits a team that wants a much larger tool count and accepts a paid license.

Sources: ClickUp MCP setup page, ClickUp MCP tools, taazkareem/clickup-mcp-server, GitHub data for that repository, Claude Code MCP, Ryze AI ClickUp guide. Checked November 18, 2026.

ClickUp and Claude Code: dates that matter

DateWhat happened
May 22, 2025Claude Code became generally available.
June 18, 2025Anthropic announced remote MCP servers in Claude Code. Version 1.0.27 brought Streamable HTTP servers and OAuth for remote servers.
February 18, 2026Claude Code 2.1.46 began to use MCP connectors from claude.ai.
June 22, 2026Claude Code 2.1.186 added claude mcp login and claude mcp logout, with --no-browser.
August 2026The Ryze AI listing joined the Anthropic Directory, by the month printed on the listing.
September 28, 2026Claude Code 2.1.284 made interactive terminal and VS Code sessions start in auto mode on every plan and provider.
November 18, 2026ClickUp's authentication page says personal tokens never expire, its rate limit page lists 100, 1,000 and 10,000 requests per minute by plan, and its MCP page says the server is available on all plans and supports OAuth only. ClickUp's pages give no launch date for its MCP server, so none is stated here.

Sources: Claude Code changelog, Anthropic, May 22, 2025, Anthropic, June 18, 2025, Ryze AI in the Anthropic Directory, ClickUp authentication, ClickUp rate limits, ClickUp MCP setup page. Checked November 18, 2026.

How this guide was tested

For this guide the Ryze AI connector was checked from the outside on November 18, 2026. No ClickUp Workspace is connected in the test workspaces, so the record is short.

What was runWhat came back
The address with no sign-in, November 18https://connector.get-ryze.ai/mcp returned HTTP 401 with a WWW-Authenticate header that points to its protected resource metadata. Claude Code's docs say a server answering 401 is marked as needing authentication, and that such a header is discovered without any setting.
The sign-in details, November 18Both discovery files on the host loaded. They list the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with the S256 and plain methods, and the scopes mcp:read and mcp:write.
ClickUp's MCP address with no sign-in, November 18https://mcp.clickup.com/mcp returned HTTP 401.
The ClickUp tool listNot seen live. The three tool names come from Ryze AI's integration manifest, because no workspace has ClickUp connected.
Calls to ClickUpNone. No tool was called and no ClickUp response is quoted on this page.

Not run for this page: the setup steps inside Claude Code. Nobody ran claude mcp add, the /mcp sign-in or the Allow connection page for this guide, so those steps follow Anthropic's docs as they read on November 14, 2026, and the Ryze AI help center. No ClickUp token was pasted into Ryze AI, so no error message from a ClickUp call is quoted here. Which OAuth client method Claude Code uses with the Ryze AI server was not checked either.

Claude Code and ClickUp errors and fixes

No ClickUp call was run for this guide, so no exact error message from ClickUp is quoted. Each fix below follows Anthropic's docs, ClickUp's docs or Ryze AI's notes.

ClickUp tools do not appear in Claude Code
Ryze AI says to remove and re-add its connector when it was added before ClickUp was connected, so the tool list refreshes. In Claude Code that means claude mcp remove ryze, the same claude mcp add command again and a new session.
The server shows Needs authentication
Claude Code marks a server that answers 401 or 403 this way. Type /mcp, select ryze and choose Authenticate, or run claude mcp login ryze.
The server shows as failed after adding an API key
A rejected Authorization header marks the connection as failed, and Claude Code does not fall back to OAuth. Replace the key or add the server again without the header.
Ryze AI rejects the token
Paste the full pk_ token from Settings > Apps > API Token. If it was regenerated since, the old one no longer works, so copy the new one.
Claude Code sees the wrong Workspace
Each connection covers one ClickUp Workspace. Reconnect the ClickUp card in Ryze AI and choose the Workspace you want.
A task or List is missing
The agent has the token owner's permissions only. A List or Space that user cannot open is not visible to Claude Code.
A Doc edit is refused
Ryze AI documents Docs as read only. Ask Claude Code to draft the text, and paste it into ClickUp yourself.
Calls fail after heavy use
ClickUp answers HTTP 429 when a token passes its plan's per-minute limit. Wait a minute or ask for fewer, narrower requests.
Claude Code says a subscription is required
The ClickUp tools need an active Ryze AI plan or free trial. Start the trial, then retry.
A claude -p run cannot sign in
Headless runs cannot open a browser. Sign in first with /mcp or claude mcp login ryze, or use a Ryze AI API key.

Terms on this page

MCP
The Model Context Protocol, an open standard that lets an AI app such as Claude Code call tools on outside systems.
Server scope in Claude Code
Where claude mcp add saves an entry: local for one project, user for all your projects, project for a .mcp.json shared through the repository.
Personal API token
A ClickUp credential that starts with pk_ and acts as the user who generated it. ClickUp says it never expires.
Workspace
ClickUp's top-level container for Spaces, Folders, Lists and tasks. A Ryze AI workspace is a different thing: the Ryze AI account area that Claude Code is allowed into.
List
The ClickUp container that holds tasks, inside a Space or a Folder.
Rate limit
ClickUp's cap on requests per minute for one token, set by the Workspace plan.
Auto mode
Claude Code's starting permission mode from version 2.1.283, in which a second model, the classifier, reviews actions in your place unless a rule decides them.

Sources: modelcontextprotocol.io, ClickUp authentication, ClickUp rate limits, Claude Code permission modes. Checked November 18, 2026.

Frequently asked questions

How do I connect Claude Code to ClickUp?

Generate a personal API token in ClickUp under Settings > Apps > API Token, then in Ryze AI open Integrations, click Connect on the ClickUp card, paste the token and choose a Workspace. In a shell run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp, type /mcp in Claude Code, select ryze, choose Authenticate and click Allow connection.

Does ClickUp have its own MCP server for Claude Code?

Yes. ClickUp's MCP server is at https://mcp.clickup.com/mcp, supports OAuth only and is available on all ClickUp plans. ClickUp's pages give no Claude Code command, so the claude mcp add syntax from Anthropic's docs is the likely route, but it was not run for this guide.

Which ClickUp connector should I use with Claude Code?

Use ClickUp's own server when Claude Code is your only assistant and you need time tracking, chat or reminders. Use the Ryze AI connector when you want ClickUp next to the other Ryze AI platforms on one address that Claude, ChatGPT and Cursor share, and a token you control, with three tools and one Workspace.

Which Claude plan does Claude Code need?

Anthropic lists Pro, Max, Ultra, Team, Enterprise or Console accounts, and the free claude.ai plan does not include Claude Code. Third-party providers work as well: Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry. Anthropic's MCP page names no extra plan for remote servers.

Which tools does Claude Code get for ClickUp?

Three: clickup__read for Workspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docs, clickup__write to create and update tasks and add comments, and clickup__delete for a task or comment. Ryze AI's notes say the tool list has not yet been seen live in a connected workspace.

Can Claude Code edit or delete ClickUp tasks?

Yes, when you ask. The write tool creates and updates tasks and adds comments, and the delete tool removes a task or comment. Add ask rules for mcp__ryze__clickup__write and mcp__ryze__clickup__delete in /permissions so Claude Code stops before each change.

Can Claude Code edit a ClickUp Doc?

Not through the Ryze AI connector. Ryze AI documents Docs as read only, and documented writes cover tasks and comments.

What ClickUp permissions does the connection use?

A personal API token that starts with pk_. The agent acts as the token owner and sees and edits what that user can. ClickUp documents no granular scopes for personal tokens.

What is the ClickUp API rate limit?

ClickUp documents 100 requests per minute per token on Free Forever, Unlimited and Business, 1,000 on Business Plus and 10,000 on Enterprise and Enterprise Plus. Past the limit the ClickUp API returns HTTP 429.

Can I use my personal API token in ClickUp's own MCP server?

No. ClickUp's MCP page says you cannot authenticate with your own API keys or access tokens and that only OAuth is supported. The Ryze AI connector uses a personal token that you paste into Ryze AI.

Can I connect more than one ClickUp Workspace?

Not on one connection. The Ryze AI notes say one connection covers one ClickUp Workspace, and the help center does not list ClickUp among the platforms that support several accounts.

Can I share the connection with my team through .mcp.json?

Yes. Add the server with --scope project and Claude Code writes .mcp.json into the repository, and each teammate approves it once in an interactive session and signs in. The ClickUp token still belongs to whoever pasted it into Ryze AI.

Why do the ClickUp tools not show up in Claude Code?

Ryze AI says to remove and re-add its connector when it was added before ClickUp was connected, so the tool list refreshes. In Claude Code run claude mcp remove ryze, add it again and start a new session. Claude Code also loads MCP tools on demand, so they appear once a task needs them.

How much does it cost to connect Claude Code to ClickUp?

Adding the connector costs nothing, but the ClickUp tools need an active Ryze AI plan or free trial. Paid Ads is $89 per month with a 7-day free trial, SEO Starter is $129 per month with a 3-day free trial and Agency is $279 per month. Annual billing takes 30% off the first year.

How do I disconnect ClickUp from Claude Code?

Run claude mcp logout ryze to clear the sign-in or claude mcp remove ryze to delete the entry. To invalidate the token, regenerate it under Settings > Apps > API Token in ClickUp.

Connect ClickUp to Claude Code

Connect ClickUp once and use the same URL in other MCP clients. Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

ClickUp MCP server

Need help? Read the Ryze AI ClickUp guide or email Ryze AI support.