# ClickUp MCP Server

> **ClickUp MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to ClickUp.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/clickup
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Manage tasks, documents, projects and operational workflows within ClickUp. Organize work, track progress and coordinate teams through structured productivity systems.

---

## Details

- Server ID: `clickup`
- Version: 1.0.0
- Tools: 79
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — ClickUp has to be in the toolset
first. In order:

1. Add ClickUp to your toolset at https://mewcp.com/mcp/clickup
2. Connect your ClickUp account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (79)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `ping` _(write)_ — Health check tool to verify the MCP server is running. No authentication required. :return: A JSON string with server status and available tool count.
- `get_authorized_user` _(write)_ — Get the user that belongs to the access token. :return: A JSON string of the authorized user information.
- `get_authorized_teams` _(write)_ — Get the authorized Workspaces (teams) for the access token. :return: A JSON string of the list of authorized teams/workspaces.
- `get_spaces` _(write)_ — Get all Spaces in a Workspace.
- `get_space` _(write)_ — Get a specific Space.
- `create_space` _(write)_ — Create a new Space in a Workspace.
- `update_space` _(write)_ — Update an existing Space.
- `delete_space` _(write)_ — Delete a Space.
- `get_folders` _(write)_ — Get all Folders in a Space.
- `get_folder` _(write)_ — Get a specific Folder.
- `create_folder` _(write)_ — Create a new Folder in a Space.
- `update_folder` _(write)_ — Update an existing Folder.
- `delete_folder` _(write)_ — Delete a Folder.
- `get_lists` _(write)_ — Get all Lists in a Folder.
- `get_folderless_lists` _(write)_ — Get all Lists in a Space that are not in a Folder.
- `get_list` _(write)_ — Get a specific List.
- `create_list` _(write)_ — Create a new List in a Folder.
- `create_folderless_list` _(write)_ — Create a new List in a Space (not in a Folder).
- `update_list` _(write)_ — Update an existing List.
- `delete_list` _(write)_ — Delete a List.
- `get_tasks` _(write)_ — Get tasks in a List.
- `get_task` _(write)_ — Get a specific task.
- `create_task` _(write)_ — Create a new task in a List.
- `update_task` _(write)_ — Update an existing task.
- `delete_task` _(write)_ — Delete a task.
- `get_filtered_team_tasks` _(write)_ — Get all tasks in a Workspace (team) with optional filters.
- `get_task_comments` _(write)_ — Get comments on a task.
- `create_task_comment` _(write)_ — Create a comment on a task.
- `get_list_comments` _(write)_ — Get comments on a list.
- `create_list_comment` _(write)_ — Create a comment on a list.
- `update_comment` _(write)_ — Update a comment.
- `delete_comment` _(write)_ — Delete a comment.
- `get_time_entries` _(write)_ — Get time entries within a date range.
- `get_single_time_entry` _(write)_ — Get a single time entry.
- `create_time_entry` _(write)_ — Create a time entry.
- `update_time_entry` _(write)_ — Update a time entry.
- `delete_time_entry` _(write)_ — Delete a time entry.
- `start_time_entry` _(write)_ — Start a timer for time tracking.
- `stop_time_entry` _(write)_ — Stop the currently running timer.
- `get_running_time_entry` _(write)_ — Get the currently running timer.
- `get_workspace_members` _(write)_ — Get all members in a Workspace.
- `get_task_members` _(write)_ — Get members assigned to a task.
- `get_list_members` _(write)_ — Get members with access to a list.
- `get_space_tags` _(write)_ — Get all tags in a Space.
- `create_space_tag` _(write)_ — Create a new tag in a Space.
- `update_space_tag` _(write)_ — Update a tag in a Space.
- `delete_space_tag` _(write)_ — Delete a tag from a Space.
- `add_tag_to_task` _(write)_ — Add a tag to a task.
- `remove_tag_from_task` _(write)_ — Remove a tag from a task.
- `get_goals` _(write)_ — Get all goals in a Workspace.
- `get_goal` _(write)_ — Get a specific goal.
- `create_goal` _(write)_ — Create a new goal.
- `update_goal` _(write)_ — Update a goal.
- `delete_goal` _(write)_ — Delete a goal.
- `create_checklist` _(write)_ — Create a new checklist in a task.
- `update_checklist` _(write)_ — Update a checklist.
- `delete_checklist` _(write)_ — Delete a checklist.
- `create_checklist_item` _(write)_ — Create a new checklist item.
- `update_checklist_item` _(write)_ — Update a checklist item.
- `delete_checklist_item` _(write)_ — Delete a checklist item.
- `get_accessible_custom_fields` _(write)_ — Get all custom fields accessible in a list.
- `set_custom_field_value` _(write)_ — Set a custom field value on a task.
- `remove_custom_field_value` _(write)_ — Remove a custom field value from a task.
- `get_team_views` _(write)_ — Get all views at the Workspace level.
- `get_space_views` _(write)_ — Get all views in a Space.
- `get_folder_views` _(write)_ — Get all views in a Folder.
- `get_list_views` _(write)_ — Get all views in a List.
- `get_view` _(write)_ — Get a specific view.
- `get_view_tasks` _(write)_ — Get tasks in a view.
- `get_webhooks` _(write)_ — Get all webhooks in a Workspace.
- `create_webhook` _(write)_ — Create a new webhook.
- `update_webhook` _(write)_ — Update a webhook.
- `delete_webhook` _(write)_ — Delete a webhook.
- `search_docs` _(write)_ — Search for Docs in a Workspace.
- `get_doc_pages` _(write)_ — Get all pages in a Doc.
- `create_doc_page` _(write)_ — Create a new page in a Doc.
- `get_chat_channels` _(write)_ — Get all chat channels in a Workspace.
- `send_chat_message` _(write)_ — Send a message to a chat channel.
- `get_shared_hierarchy` _(write)_ — Get the shared hierarchy for a Workspace. Returns all resources shared with the authenticated user.

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/clickup/connect/claude
- ChatGPT: https://mewcp.com/mcp/clickup/connect/chatgpt
- VS Code: https://mewcp.com/mcp/clickup/connect/vscode
- Cursor: https://mewcp.com/mcp/clickup/connect/cursor
- Codex: https://mewcp.com/mcp/clickup/connect/codex
- Claude Code: https://mewcp.com/mcp/clickup/connect/claude-code
- OpenCode: https://mewcp.com/mcp/clickup/connect/opencode
- OpenClaw: https://mewcp.com/mcp/clickup/connect/openclaw
- Antigravity: https://mewcp.com/mcp/clickup/connect/antigravity
- Hermes: https://mewcp.com/mcp/clickup/connect/hermes
- DeepSeek Harness: https://mewcp.com/mcp/clickup/connect/dsh
- Python: https://mewcp.com/mcp/clickup/connect/python
- TypeScript: https://mewcp.com/mcp/clickup/connect/typescript