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.
- In ClickUp open Settings > Apps > API Token and click Generate
- In Ryze AI open Integrations, click Connect on the ClickUp card, paste the pk_ token and choose the Workspace
- In a shell, outside any Claude Code session, run the claude mcp add command, then type /mcp and pick Authenticate
- Tick the Ryze AI workspace, click Allow connection and ask a ClickUp question
Claude Code to ClickUp at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, a hosted MCP server that Claude Code registers with one claude mcp add command |
| Server address | https://connector.get-ryze.ai/mcp, added with the HTTP transport |
| Sign-in | A 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 tools | 3: clickup__read, clickup__write and clickup__delete |
| Can Claude Code change ClickUp | Yes. 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 data | The same address serves the other platforms connected in your Ryze AI workspace |
| Claude Code plan | Pro, Max, Ultra, Team, Enterprise or Console. The free claude.ai plan does not include Claude Code |
| ClickUp access you need | Any ClickUp user who can open Settings > Apps and generate a personal token. The agent sees what that user sees |
| Ryze AI price | Paid Ads is $89 per month with a 7-day free trial. Adding the connector costs nothing |
| ClickUp's own option for Claude Code | ClickUp'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 tested | Connector 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.
Generate a ClickUp personal API token
In ClickUp open Settings > Apps, find API Token and click Generate. Copy the token, which starts with pk_.
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.
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.
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.
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.
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 userThis 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
| Topic | What 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 |
| Transports | HTTP, the recommended one for remote servers; SSE, deprecated; stdio for a local process; WebSocket in JSON config only |
| Sign-in | OAuth 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 approval | From 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 loading | Tool search is on by default, so MCP tools are deferred and loaded when a task needs them |
| Where servers are managed | claude mcp list, get, remove, login and logout in the shell; /mcp inside a session to authenticate, reconnect or switch a server off |
| Plan | Pro, Max, Ultra, Team, Enterprise or Console. The MCP page adds no plan for remote servers |
| Admin controls | Admins 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.
| Access | What it covers | Through which tool |
|---|---|---|
| Read | Workspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docs | clickup__read |
| Create and update | Creating a task, updating a task and adding a comment | clickup__write |
| Delete | Deleting a task or a comment by path | clickup__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.
| Tool | Type | What it does |
|---|---|---|
| clickup__read | Read | Reads ClickUp data with GET requests: Workspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docs. |
| clickup__write | Write | Creates or updates ClickUp objects with POST or PUT, such as creating a task, adding a comment or updating a task. |
| clickup__delete | Delete | Deletes 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
| Limit | Number | Source |
|---|---|---|
| ClickUp API requests per minute, Free Forever, Unlimited and Business | 100 per token | ClickUp rate limits |
| ClickUp API requests per minute, Business Plus | 1,000 per token | ClickUp rate limits |
| ClickUp API requests per minute, Enterprise and Enterprise Plus | 10,000 per token | ClickUp rate limits |
| When the ClickUp limit is exceeded | HTTP 429 from the ClickUp API | ClickUp rate limits |
| Ryze AI notes on the ClickUp limit | 100 requests per minute per token | Ryze AI ClickUp guide |
| ClickUp connections per Ryze AI connection | 1 Workspace | Ryze AI ClickUp guide |
| Claude Code tool result warning | 10,000 tokens | Claude Code MCP |
| Claude Code tool result default limit | 25,000 tokens, changed with MAX_MCP_OUTPUT_TOKENS | Claude Code MCP |
| Claude Code idle time per HTTP tool call | 5 minutes without a response or progress | Claude Code MCP |
| ClickUp's own MCP server, per connection | 1,000 requests per minute, shown for comparison | ClickUp MCP tools |
| ClickUp's own MCP server, per day | Without 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 Plus | Connect 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.
| Job | Ask Claude Code | Tool | Default connection |
|---|---|---|---|
| Workspace map | List my Spaces, Folders and Lists. | clickup__read | Yes |
| Overdue tasks | Which tasks assigned to me are past their due date? | clickup__read | Yes |
| Task detail | Show the description, assignees and custom fields of the task I name. | clickup__read | Yes |
| Comment thread | Summarize the comments on a task. | clickup__read | Yes |
| Team list | List the members of the Workspace. | clickup__read | Yes |
| Read a Doc | Find the Doc I name and summarize it. | clickup__read | Yes |
| Create a task | Create a task with this name in this List. | clickup__write | Yes, and an ask rule makes Claude Code stop first |
| Update a task | Update the task I name with this change. | clickup__write | Yes, and an ask rule makes Claude Code stop first |
| Remove a task | Delete the task I name. | clickup__delete | Yes, only when you ask, and add an ask rule first |
| Edit a Doc | Rewrite this Doc. | none | No. 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.
| Way | Runs where | Setup in Claude Code | What it reaches in ClickUp | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one address for every user | claude 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 too | 3 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 connection | Paid Ads is $89 per month with a 7-day free trial. The connector is free to add |
| ClickUp's MCP server | Hosted by ClickUp at https://mcp.clickup.com/mcp | ClickUp'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 used | ClickUp'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 task | ClickUp says it is available on all plans, with daily call limits by plan |
| taazkareem/clickup-mcp-server, community | Hosted at https://clickup-mcp.taazkareem.com/mcp, or self-hosted | Its README gives claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp with an X-License-Key header | The README counts 150 tools | Proprietary 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
| Date | What happened |
|---|---|
| May 22, 2025 | Claude Code became generally available. |
| June 18, 2025 | Anthropic announced remote MCP servers in Claude Code. Version 1.0.27 brought Streamable HTTP servers and OAuth for remote servers. |
| February 18, 2026 | Claude Code 2.1.46 began to use MCP connectors from claude.ai. |
| June 22, 2026 | Claude Code 2.1.186 added claude mcp login and claude mcp logout, with --no-browser. |
| August 2026 | The Ryze AI listing joined the Anthropic Directory, by the month printed on the listing. |
| September 28, 2026 | Claude Code 2.1.284 made interactive terminal and VS Code sessions start in auto mode on every plan and provider. |
| November 18, 2026 | ClickUp'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 run | What came back |
|---|---|
| The address with no sign-in, November 18 | https://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 18 | Both 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 18 | https://mcp.clickup.com/mcp returned HTTP 401. |
| The ClickUp tool list | Not seen live. The three tool names come from Ryze AI's integration manifest, because no workspace has ClickUp connected. |
| Calls to ClickUp | None. 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.