Skip to content

Connect Claude to ClickUp

Connect Claude to ClickUp through ApexGenius. Search tasks and docs, read comments and time, and create or update work in your connected workspace.

7 days free · No card required

How to connect ClickUp to Claude

Before you start

  • An account with permission to use the ClickUp resources you intend to connect.

1. Connect ClickUp to ApexGenius

  1. Open ClickUp in Connections. Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.
  2. Choose the account and review access. Sign in to ClickUp in the browser and choose the workspace to allow if ClickUp asks. ClickUp uses browser authorization; no API key is pasted into ApexGenius.
    The full ClickUp login page for the ClickUp MCP Service, with a red box around the login form.
    Connect opens ClickUp's login for the ClickUp MCP Service. Log in with SSO or your work email, then allow ApexGenius.Open full-size image (opens in a new tab)
  3. Review the connected account and resources. Confirm the connected ClickUp account and workspace. Open Tools to review the task, list, doc, chat and time tools. ClickUp limits MCP calls per day by plan.
  4. Check the connection. Use Test connection or Check again and read the reported status. Add an AI agent from the AI agents page, choose Read only for the first test, and try the question below.
Connect ClickUp

2. Add ApexGenius to Claude

Use this server address when adding the connection:

https://server.autom8.pro/mcp
  1. Open Claude Settings, then Connectors, then Add custom connector.
  2. Enter ApexGenius and the MCP URL above. Choose Connect.
  3. Approve it in your browser, then turn it on in chat or Cowork.
  4. When ApexGenius asks what this AI client may use, choose Read only for the first test, or Custom to limit it to the tools you need.
  5. Start a new conversation and select ApexGenius from the available tools before asking for live data.

Watch the connection

7-second loop · Silent, with captions

Read the steps Follow along at your own pace

1. Open Connectors

Claude Desktop Connectors settings with the Add menu at the top and an ApexGenius example in the connector table.
Open Settings, then Connectors. Choose Add at the top; an existing installation appears in the table like this example.Open full-size image (opens in a new tab)

2. Add ApexGenius

Claude Desktop Add custom connector form filled with the ApexGenius name and remote MCP server URL.
Choose Add custom connector, enter the two live values above, and choose Continue. No client id or secret belongs in this form.Open full-size image (opens in a new tab)

3. Review permissions

Claude Desktop ApexGenius connector details showing the remote server URL and Tool permissions heading.
After approval, open ApexGenius from Connectors to review its URL and tool permissions. This capture is an existing configured example.Open full-size image (opens in a new tab)

3. Verify one safe read

Show the spaces, folders and lists in my connected ClickUp workspace. Do not create or change anything.

Show the spaces, folders and lists in my connected ClickUp workspace. Do not create or change anything.

Compare the returned account and resource with ClickUp. Check the connection status separately from the result of the first read.

Additional reference: the ClickUp setup guide.

Start free

What it looks like in Claude Cowork

An illustrative read-only request and response. Your results come from the account and dates you choose.

How the route works
Claude
Claude CoworkApexGenius MCP route
Show the spaces, folders and lists in my ClickUp workspace. Do not change anything.
ApexGenius
Working with ApexGenius1 tool search · 1 read
RequestMap the workspace
Account scopeAuthorized connections checked
apex_search_toolsClickUp workspace · Find ClickUp readsComplete
apex_call_read_toolGet Workspace Hierarchy · Read the workspace hierarchyComplete
Claude

Illustrative example: the workspace has three spaces, Product, Marketing and Operations. Product holds a Sprint folder with Backlog and Sprint 12 lists. Nothing was changed.

Read-only route
Claude Cowork

What you can ask once it is connected

Show the spaces, folders and lists in my ClickUp workspace. Do not change anything.

List the open tasks in the Sprint list with their assignees and due dates.

Summarize the comments on this task and list the action items.

Create a task in the list I name, assign it to me, and set the due date for Friday.

You choose what Claude is allowed to touch

Choose the saved accounts and tools this Claude connection may use. Its authorization carries that scope, and each app connection’s tool and resource restrictions still apply.

  • Full accessEvery enabled tool on the connections you choose.
  • Read onlyLooks things up, changes nothing.
  • CustomPick apps and tools one by one.
  • · ClickUp sets the boundary. The connection reaches what the signed-in ClickUp user can reach in the authorized workspace.
  • · Reads use a route that checks ClickUp's own read-only label before every call.
  • · Writes run right away. If the owner set a tool to Ask me first (approval mode always), the call returns approval_required; a person approves it in ApexGenius and you retry with the returned approval_request_id.
  • · ClickUp limits MCP calls by plan: without the Everything AI add-on, 50 calls per 24 hours on Free Forever and 300 on Unlimited and above. ClickUp's MCP server is in public beta.
  • · Disconnecting stops future gateway access. It does not undo a task change, comment, chat message or deletion that already ran.

The ClickUp operations Claude can run

48 operations: 20 Read and 28 Write. Available tools depend on your connection and permissions. Review any action that changes or removes data. Claude discovers these operations through the ApexGenius gateway.

  • Search WorkspaceReadSearch tasks, lists, folders and docs across the workspace.
  • Search tasks by task typeReadFind tasks of one task type, such as bugs.
  • Search tasks by tagReadFind tasks that carry a tag.
  • Get TaskReadRead the full details of one task by its ID.
  • Get Task CommentsReadRead all comments on a task.
  • Get Threaded RepliesReadRead the replies under one task comment.
  • Get Workspace HierarchyReadRead every space, folder and list in the workspace, with IDs.
  • Get ListReadRead one list, including its statuses.
  • Get FolderReadRead one folder and the lists inside it.
  • Get Task Time EntriesReadRead the time logged on one task.
  • Get time entries for multiple tasksReadRead total time for tasks in a space, folder or list.
  • Get Current Time EntryReadCheck whether a timer is running and on which task.
  • Get Time in Status for a taskReadRead how long a task has spent in each status.
  • Get Time in Status for tasks in a ListReadRead time in status for the tasks in a list.
  • Get Workspace MembersReadList the members and guests in the workspace.
  • Find Member by NameReadFind a member by name or email.
  • Resolve AssigneesReadMatch names to user IDs before assigning a task.
  • Get Chat ChannelsReadList the Chat channels in the workspace.
  • List Document PagesReadList the pages in a doc.
  • Get Document PagesReadRead the content of one or more doc pages.
  • Create TaskWriteCreate a task in a list with name, description, assignees, due date and priority.
  • Update TaskWriteChange a task's name, description, status, assignees or due date.
  • Set Custom FieldsWriteSet custom field values on a task.
  • Create Bulk TasksWriteCreate several tasks in one list in one call.
  • Update Bulk TasksWriteChange status, assignee or due date on many tasks at once.
  • Create Task CommentWritePost a comment on a task. An @mention notifies that person.
  • Attach File to TaskWriteUpload a file and attach it to a task.
  • Add Tag to TaskWriteApply an existing tag to a task.
  • Remove Tag from TaskWriteRemove a tag from a task.
  • Add task linkWriteLink two related tasks.
  • Remove task linkWriteRemove the link between two tasks.
  • Add dependencyWriteMark that one task waits on another.
  • Remove dependencyWriteRemove a dependency between tasks.
  • Move task to a new ListWriteMove a task to a different home list.
  • Add task to another ListWriteShow a task in a second list as well.
  • Create ListWriteCreate a list in a folder or space.
  • Create List in FolderWriteCreate a list inside a named folder.
  • Update ListWriteRename a list or change its settings.
  • Create FolderWriteCreate a folder in a space.
  • Update FolderWriteRename a folder or change its settings.
  • Start Time TrackingWriteStart a timer on a task for the signed-in user.
  • Stop Time TrackingWriteStop the running timer.
  • Add Time EntryWriteLog a block of time on a task.
  • Send Chat MessageWritePost a message to a Chat channel. It is sent at once.
  • Create DocumentWriteCreate a doc in a space, folder or private docs.
  • Create Document PageWriteAdd a page or sub-page to a doc.
  • Update Document PageWriteEdit the content of a doc page.
  • Delete taskWriteDelete a task or subtask. Restoring it happens in ClickUp itself.

Questions people ask first

How do I connect ClickUp?

Open ClickUp in ApexGenius Connections, choose Connect, and sign in to ClickUp in the browser. ClickUp uses browser authorization, so no API key is pasted into ApexGenius.

What can my AI read in ClickUp?

What the signed-in ClickUp user can read in the authorized workspace: spaces, folders and lists, tasks and comments, docs, Chat channels, members and time entries.

Do changes wait for me?

Writes run right away. If the owner set a tool to Ask me first (approval mode always), the call returns approval_required; a person approves it in ApexGenius and you retry with the returned approval_request_id.

Can my AI delete a task?

ClickUp documents a Delete task tool, and it is labelled Destructive here. A deleted task is restored in ClickUp itself, not through ApexGenius. Comments and Chat messages notify people as soon as they are posted.

Does ClickUp limit MCP calls?

Yes. Without the Everything AI add-on, ClickUp allows 50 MCP calls per 24 hours on the Free Forever plan and 300 on Unlimited and above. With the add-on, ClickUp's Public API limits apply.

Can I take this setup to another AI agent?

Yes. Add ApexGenius to another compatible agent with the same ApexGenius account. It can use the ClickUp connection and read the ClickUp skill. Each agent needs its own setup and access choices.

Connect ClickUp to Claude today

Start free

7 days free. No card required. Disconnect any time.