Clickup Mcp

ClickUp MCP Server (amazing-clickup-mcp)

A comprehensive Model Context Protocol server for the ClickUp public API (v2 + v3), built on the official MCP Python SDK (FastMCP, stdio transport). It exposes 166 tools covering nearly the entire ClickUp surface — Spaces, Folders, Lists, Views, Docs, Tasks, Comments, Checklists, Tags, Custom Fields, Time Tracking, Goals, Members, Guests, Webhooks, Chat, and more — so an LLM can read and drive a ClickUp Workspace on your behalf.

> The PyPI distribution and console script are both amazing-clickup-mcp (the bare > clickup-mcp name is taken on PyPI by an unrelated package). Always run > uvx amazing-clickup-mcp — never uvx clickup-mcp.

Features

• Full API coverage (166 tools). v2 and v3 endpoints across 22 resource groups —

Spaces, Folders, Lists, Views, Docs, Tasks, Comments, Checklists, Tags, Custom Fields, Time Tracking 2.0, Relationships, Attachments, Goals, Members & User Groups, Guests, Users, Webhooks, Workspace admin, Chat channels, Chat messages, and a health check.

• Statuses managed via payloads. ClickUp has no dedicated statuses endpoint; create

and update Space/Folder/List objects with statuses/override_statuses payloads.

• Docs created in-place (v3). Create a Doc directly in its final Space/Folder/List/

Everything location — no drag-later.

• Dual-format responses. Markdown for humans and LLMs (default) or JSON for

programmatic use, selectable per call via response_format.

• Strict input validation. One pydantic v2 model per tool (extra="forbid",

field-level constraints) so malformed calls fail fast with a clear message.

• Uniform error mapping. 400/401/403/404/429, timeouts, and connection errors are

normalized into readable strings that surface ClickUp err/ECODE details and rate-limit guidance.

• stdio-only transport. No HTTP/SSE and no logging to stdout — the standard input/

output channel is the MCP protocol channel.

Available Tools

All 166 tools, grouped by resource. Read tools return either markdown (default) or JSON; mutating tools return a human-readable confirmation.

| Tool | Description | |---|---| | Spaces | | | clickup_create_space | Create a new Space inside a Workspace. | | clickup_get_spaces | List the Spaces in a Workspace. | | clickup_get_space | Fetch full detail for a single Space, including its status workflow and ClickApp toggles. | | clickup_update_space | Rename a Space, change its color/privacy, or replace its ClickApp/status configuration. | | clickup_delete_space | Permanently delete a Space and everything inside it. | | Folders | | | clickup_create_folder | Create a Folder inside a Space. | | clickup_get_folders | List the Folders in a Space. | | clickup_get_folder | Fetch one Folder, including its Lists and status workflow. | | clickup_update_folder | Rename a Folder and/or toggle its status-override setting. | | clickup_delete_folder | Permanently delete a Folder and every List/Task inside it. | | clickup_create_folder_from_template | Create a new Folder by replaying a Folder template. | | clickup_get_folder_templates | List the Folder templates available in a Workspace. | | Lists | | | clickup_create_list | Create a new List inside a Folder. | | clickup_create_folderless_list | Create a new List directly inside a Space, with no parent Folder. | | clickup_get_lists | List the Lists that belong to a Folder. | | clickup_get_folderless_lists | List the Lists that live directly inside a Space (no Folder). | | clickup_get_list | Fetch full detail for a single List by id. | | clickup_update_list | Update a List's name, description, dates, priority, assignee, or color. | | clickup_delete_list | Permanently delete a List from the Workspace. | | clickup_add_task_to_list | Add an existing Task's membership to an additional List. | | clickup_remove_task_from_list | Remove a Task's membership from an additional (non-home) List. | | clickup_create_list_from_template_in_folder | Create a new List inside a Folder by instantiating a List template. | | clickup_create_list_from_template_in_space | Create a new folderless List inside a Space by instantiating a template. | | clickup_get_list_templates | List available List templates for a Workspace. | | Views | | | clickup_create_team_view | Create a task or page view at the Everything Level of a Workspace. | | clickup_create_space_view | Create a task or page view scoped to a Space. | | clickup_create_folder_view | Create a task or page view scoped to a Folder. | | clickup_create_list_view | Create a task or page view scoped to a List. | | clickup_get_team_views | List the task and page views defined at the Everything Level of a Workspace. | | clickup_get_space_views | List the task and page views available for a Space. | | clickup_get_folder_views | List the task and page views available for a Folder. | | clickup_get_list_views | List the task and page views available for a List. | | clickup_get_view | Get the full configuration of a single task or page view. | | clickup_get_view_tasks | List the tasks currently visible in a view, honoring its filters and sorting. | | clickup_update_view | Rename a view and/or replace its grouping/sorting/filters/columns/settings. | | clickup_delete_view | Permanently delete a task or page view. | | Docs | | | clickup_search_docs | Search the Docs in a Workspace, optionally filtered by parent location. | | clickup_create_doc | Create a Doc, optionally placed directly in its final location. | | clickup_get_doc | Fetch a single Doc's metadata (name, parent, timestamps). | | clickup_get_doc_page_listing | List a Doc's page tree (titles and ids only, nested — no content). | | clickup_get_doc_pages | Fetch a Doc's pages with content (the full readable body of the Doc). | | clickup_create_page | Add a page to an existing Doc (optionally nested under another page). | | clickup_get_page | Fetch one page of a Doc, including its content. | | clickup_edit_page | Update a Doc page's title, subtitle, and/or content. | | Tasks | | | clickup_create_task | Create a task inside a List. | | clickup_get_task | Fetch one task by id. | | clickup_get_tasks | List tasks inside ONE List, with filters and sorting. | | clickup_update_task | Update fields on an existing task. | | clickup_delete_task | Permanently delete a task. | | clickup_get_filtered_team_tasks | Search tasks across the ENTIRE Workspace with rich filters. | | clickup_move_task | Move a task to a new home List. | | clickup_merge_tasks | Merge one or more source tasks into a target task. | | clickup_create_task_from_template | Create a task in a List from a saved task template. | | clickup_get_task_templates | List the Workspace's saved task templates. | | clickup_get_task_time_in_status | Report how long one task has spent in each status. | | clickup_get_bulk_tasks_time_in_status | Report time-in-status for 2 to 100 tasks in one call. | | Comments | | | clickup_create_task_comment | Add a comment to a task. | | clickup_get_task_comments | List comments on a task, newest first. | | clickup_create_list_comment | Add a comment to a List's info panel. | | clickup_get_list_comments | List comments on a List's info panel, newest first. | | clickup_create_chat_view_comment | Post a comment into a Chat view. | | clickup_get_chat_view_comments | List comments in a Chat view, newest first. | | clickup_update_comment | Edit a comment's text, (re)assign it, or toggle its resolved state. | | clickup_delete_comment | Permanently delete a comment. | | clickup_create_threaded_comment | Reply inside an existing comment's thread. | | clickup_get_threaded_comments | List the replies in a comment's thread. | | Checklists | | | clickup_create_checklist | Add a new (empty) checklist to a task. | | clickup_edit_checklist | Rename a checklist and/or reposition it among a task's other checklists. | | clickup_delete_checklist | Permanently remove a checklist (and all of its items) from its task. | | clickup_create_checklist_item | Add a new line item to an existing checklist. | | clickup_edit_checklist_item | Rename, (un)resolve, reassign, or nest/un-nest a checklist item. | | clickup_delete_checklist_item | Remove a single line item from a checklist (the checklist itself stays). | | Tags | | | clickup_get_space_tags | List every task Tag defined in a Space, with its foreground/background colors. | | clickup_create_space_tag | Add a new task Tag (with optional colors) to a Space's tag palette. | | clickup_edit_space_tag | Rename and/or recolor an existing Space tag. | | clickup_delete_space_tag | Remove a tag from a Space's palette (and from every task carrying it). | | clickup_add_tag_to_task | Apply an existing Space tag to a task. | | clickup_remove_tag_from_task | Remove a tag from a task without deleting the tag from the Space. | | Custom Fields | | | clickup_get_list_custom_fields | List the Custom Fields accessible from a List. | | clickup_get_folder_custom_fields | List the Custom Fields available at a Folder scope. | | clickup_get_space_custom_fields | List the Custom Fields available at a Space scope. | | clickup_get_team_custom_fields | List the Workspace-scoped Custom Fields. | | clickup_set_custom_field_value | Set a Custom Field's value on a task. | | clickup_remove_custom_field_value | Clear a Custom Field's value on a task. | | clickup_get_custom_task_types | List the Workspace's custom task types (a.k.a. custom items). | | Time Tracking | | | clickup_get_time_entries | List time entries in a Workspace, optionally scoped by date range and location. | | clickup_get_time_entry | Fetch one time entry by id. | | clickup_get_time_entry_history | View the list of changes made to a time entry. | | clickup_get_running_time_entry | Get the currently running time entry for a user, if any. | | clickup_create_time_entry | Log a completed (already-finished) time entry. | | clickup_update_time_entry | Edit an existing time entry's description, tags, times, task, or billable flag. | | clickup_delete_time_entry | Permanently delete one or more time entries. | | clickup_start_time_entry | Start a new, open-ended running timer for the authenticated user. | | clickup_stop_time_entry | Stop the authenticated user's currently running timer. | | clickup_get_time_entry_tags | List every tag ever applied to a time entry in this Workspace. | | clickup_add_time_entry_tags | Apply one or more tags to one or more time entries. | | clickup_remove_time_entry_tags | Remove one or more tags from one or more time entries. | | clickup_rename_time_entry_tag | Rename a time-entry tag (and set its colors) across the whole Workspace. | | clickup_replace_time_estimates_by_user | Overwrite a task's entire set of per-assignee time estimates. | | clickup_update_time_estimates_by_user | Set or adjust specific assignees' time estimates on a task, leaving others unchanged. | | Relationships | | | clickup_add_dependency | Create a blocking dependency between two tasks. | | clickup_delete_dependency | Remove a blocking dependency edge between two tasks. | | clickup_add_task_link | Link two tasks with a non-blocking "related to" association. | | clickup_delete_task_link | Remove a "related to" link between two tasks. | | Attachments | | | clickup_create_task_attachment | Upload a local file to a task as an attachment (v2). | | clickup_get_entity_attachments | List the attachments of a task or File-type Custom Field (v3). | | clickup_create_entity_attachment | Upload a local file to a task or File-type Custom Field (v3). | | Goals | | | clickup_create_goal | Create a new Goal in a Workspace. | | clickup_get_goals | List the Goals in a Workspace, including any Goal Folders. | | clickup_get_goal | Get a single Goal's full detail, including its Key Results. | | clickup_update_goal | Update an existing Goal's name, due date, description, owners, or color. | | clickup_delete_goal | Permanently delete a Goal and all of its Key Results. | | clickup_create_key_result | Add a Key Result (Target) to a Goal. | | clickup_edit_key_result | Update a Key Result's progress, note, name, owners, or task/list links. | | clickup_delete_key_result | Permanently delete a Key Result (Target) from its Goal. | | Members & Groups | | | clickup_get_list_members | List the Workspace members with direct access to a List. | | clickup_get_task_members | List the Workspace members with direct access to a Task. | | clickup_create_user_group | Create a User Group (ClickUp's endpoint calls this a "Team") in a Workspace. | | clickup_get_user_groups | List the User Groups in a Workspace (ClickUp's endpoint slug: "getteams1"). | | clickup_update_user_group | Rename a User Group and/or add/remove its members. | | clickup_delete_user_group | Permanently delete a User Group from a Workspace. | | clickup_get_custom_roles | List the Custom Roles configured for a Workspace. | | clickup_get_shared_hierarchy | List the Tasks, Lists, and Folders individually shared with the caller. | | Guests (Enterprise) | | | clickup_invite_guest_to_workspace | Invite an external guest to a Workspace by email. | | clickup_edit_guest_on_workspace | Update an existing guest's permission flags or custom role on a Workspace. | | clickup_get_guest | Look up a guest's permission flags and what has been shared with them. | | clickup_remove_guest_from_workspace | Revoke a guest's access to an entire Workspace. | | clickup_add_guest_to_task | Share a single task with an existing guest at a given permission level. | | clickup_remove_guest_from_task | Revoke a guest's access to a single task. | | clickup_add_guest_to_list | Share a List with an existing guest at a given permission level. | | clickup_remove_guest_from_list | Revoke a guest's access to a List. | | clickup_add_guest_to_folder | Share a Folder with an existing guest at a given permission level. | | clickup_remove_guest_from_folder | Revoke a guest's access to a Folder. | | Users (Enterprise) | | | clickup_invite_user_to_workspace | Invite a full member to a Workspace by email. | | clickup_edit_user_on_workspace | Update a Workspace member's username, admin flag, or custom role. | | clickup_get_user | Look up a single Workspace member's profile, role, and admin status. | | clickup_remove_user_from_workspace | Deactivate a full member's access to a Workspace. | | Webhooks | | | clickup_create_webhook | Register a webhook that pushes ClickUp events to your endpoint. | | clickup_get_webhooks | List the webhooks registered in a Workspace, with their delivery health. | | clickup_update_webhook | Change a webhook's endpoint, event subscription, or delivery status. | | clickup_delete_webhook | Permanently delete a webhook, stopping all event delivery to its endpoint. | | Workspace | | | clickup_get_workspace_plan | Report the current subscription plan of a Workspace. | | clickup_get_workspace_seats | Report used, total, and available member and guest seats for a Workspace. | | clickup_query_audit_logs | Query a Workspace's audit trail (Enterprise, Workspace owner only). | | clickup_update_privacy_and_access | Set the privacy of an object and grant/revoke user or group access (Enterprise). | | Chat Channels | | | clickup_get_chat_channels | List the Chat channels in a Workspace, with descriptor filters. | | clickup_create_chat_channel | Create a Workspace-level Chat channel by name. | | clickup_create_location_chat_channel | Create a Chat channel bound to a Space, Folder, or List. | | `clickup_cr

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: trustxai
• Source: trustxai/clickup-mcp
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.