ClickUp
Manage projects, tasks, and documents directly through a comprehensive suite of productivity tools.
What it can do
- Ping: Echo request for connectivity checks.
- Health: Report server readiness and enforced safety limits.
- Tool Catalogue: Enumerate all available tools with their annotations.
What data it sees
Do you need an account
An API key from the service settings is required
Manage projects, tasks, and documents directly through a comprehensive suite of productivity tools. Search for tasks, generate status reports, and track time entries across entire workspaces. Access document hierarchies and member information to streamline collaboration and project oversight.
How to connect
How to connect ClickUp to Claude
The server address to paste into Claude settings:
https://clickup-mcp--polaralias.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect ClickUp to ChatGPT
The server address to paste into ChatGPT settings:
https://clickup-mcp--polaralias.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect ClickUp to Cursor
The server address to paste into Cursor settings:
https://clickup-mcp--polaralias.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (41)
Raw names from tools/list. Only developers need these.
| ping | Echo request for connectivity checks. |
| health | Report server readiness and enforced safety limits. |
| tool_catalogue | Enumerate all available tools with their annotations. |
| workspace_capability_snapshot | Expose cached ClickUp capability probes for this session. |
| workspace_list | List accessible ClickUp workspaces (teams). Use when you need workspace IDs before exploring spaces. |
| space_list_for_workspace | List spaces for a workspace by workspaceId. Use search when you only know workspace names. |
| folder_list_for_space | List folders within a ClickUp space. Use when you already know spaceId. |
| list_list_for_space_or_folder | List lists inside a space or folder by ID. If you only know names, resolve them first with resolve_path_to_ids. |
| workspace_overview | Summarise workspace metrics and recent spaces/folders/lists when you have a workspaceId. |
| workspace_hierarchy | Fetch nested hierarchy (spaces, folders, lists) for one or more workspaces. Use this to browse structure without task data. |
| hierarchy_resolve_path | Resolve workspace/space/folder/list names into IDs. Use before tools that require IDs. |
| member_list_for_workspace | List members in a workspace by teamId. Use when you already know the workspaceId. |
| member_resolve | Resolve member identifiers (id, email, username) into member records for a workspace. |
| member_search_by_name | Fuzzy search member names to find member IDs. |
| task_assignee_resolve | Translate assignee references into suggested member IDs for tasks. |
| space_tag_list | List tags configured for a space using spaceId. |
| reference_link_list | List public ClickUp API reference links. |
| reference_page_fetch | Fetch a public ClickUp API reference page from a link returned by reference_link_list. |
| task_search | Structured task search with filters. Use when you have listIds/tagIds; returns tasks across lists. |
| task_search_fuzzy | Fuzzy task search from natural language when you do not have precise filters. |
| task_search_fuzzy_bulk | Batch fuzzy task searches for multiple natural language prompts. |
| task_status_report | Summarise task status and priority for a workspace, space, folder or list without returning full task lists. |
| task_risk_report | Summarise overdue and at-risk tasks within a workspace, space, folder or list. Subtasks are included by default; use includeSubtasks to focus on parent tasks and inspect isSubtask/parentId in results to understand hierarchy. |
| task_read | Fetch task details including createdDate/updatedDate fields derived from ClickUp timestamps. Subtask cues (isSubtask, parentId, hasSubtasks, subtaskCount) are included; check them before claiming there are no subtasks. GET /task/{task_id} |
| task_list_for_list | List tasks in a list. Tasks linked from other lists are included by default (include_timl=true). Outputs include createdDate derived from ClickUp date_created and hierarchy cues (isSubtask, parentId, hasSubtasks, subtaskCount). Always review hasSubtasks/subtaskCount before asserting there are no subtasks. Results are paginated and may span multiple pages; iterate via the page input to retrieve additional pages. GET /list/{list_id}/task |
| task_comment_list | Retrieve task comments for a taskId. |
| list_custom_field_list | List custom fields configured for a list by listId. |
| doc_list | List documents within a workspace using filters. |
| doc_read | Fetch document metadata and pages for a docId. |
| doc_pages_read | Fetch selected document pages by docId and pageIds. |
| doc_page_list | List page hierarchy for a document by docId. |
| doc_page_read | Fetch a single document page by docId and pageId. |
| doc_search | Search document content across a workspace. Use doc_page_read for specific pages. |
| doc_search_bulk | Batch document searches when you need several queries processed together. |
| task_time_entry_list | Fetch time entries for a taskId, including total duration. |
| time_entry_current | Retrieve the current running timer for the workspace. |
| time_entry_list | List time entries with filters. Accepts ISO 8601 or epoch boundaries; include taskId when focusing on a single task. |
| time_report_for_tag | Aggregate logged time for a tag across the workspace. Use space_tag_list to discover tags, and includeSubtasks to control whether child task time is counted. |
| time_report_for_container | Aggregate time for a workspace, space, folder or list using containerId + containerType. Resolve IDs with resolve_path_to_ids, list_workspaces/spaces/folders/lists, and set includeSubtasks to clarify hierarchy handling. |
| time_report_for_context | Aggregate time for a task, list (including filtered views), space or workspace. Use search_tasks or task_list_for_list to source listId/taskId before calling. Subtask handling is explicit via includeSubtasks. |
| time_report_for_space_tag | Aggregate time for a tag within a space using spaceId. Use space_tag_list to pick the tag and includeSubtasks to control hierarchy. |