clickup-mcp
Exposes the ClickUp REST API v2 as MCP tools, enabling management of workspaces, spaces, folders, lists, tasks, custom fields, assignees, tags, checklists, attachments, members, comments, goals, views, webhooks, and time tracking through natural language.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@clickup-mcp show me all tasks in the Marketing list"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
clickup-mcp
A thin Model Context Protocol (MCP) server that exposes the full ClickUp REST API v2 as MCP tools.
Connect any MCP-compatible client (Claude Desktop, Cursor, etc.) to manage your ClickUp workspaces through natural language.
Features
Workspaces & Teams — list workspaces, get workspace members
Spaces — CRUD operations on spaces
Folders — CRUD operations on folders
Lists — CRUD operations on lists, folderless lists
Tasks — full task lifecycle: create, read, update, delete, move, duplicate
Task Fields — custom fields, assignees, tags, checklists, attachments
Members — workspace and list members
Comments — task and list comments
Goals & Key Results — create and track goals
Views — workspace, space, folder, and list views
Webhooks — create and manage webhooks
Time Tracking — log and query time entries
Related MCP server: clickup-mcp
Setup
1. Get a ClickUp API Token
Go to ClickUp → Settings → Apps and generate a personal API token.
2. Install
npm install -g clickup-mcp3. Configure Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"clickup": {
"command": "clickup-mcp",
"env": {
"CLICKUP_API_TOKEN": "your_token_here"
}
}
}
}4. Run directly
CLICKUP_API_TOKEN=your_token clickup-mcpEnvironment Variables
Variable | Required | Description |
| Yes | Personal API token from ClickUp Settings → Apps |
| No | Default team/workspace ID (used when not specified in tool calls) |
Development
git clone https://github.com/MohanadAlrefaai/clickup-mcp.git
cd clickup-mcp
npm install
npm run devLicense
MIT
Available Tools
97 toolsadd_tag_to_taskC
Add a tag to a task
Inputs: task_id (required), tag_name (required).
add_task_dependencyC
Add a dependency between tasks
Inputs: task_id (required), depends_on, dependency_of.
add_task_linkC
Link two tasks together
Inputs: task_id (required), links_to (required), team_id, custom_task_ids.
add_task_watcherC
Add a watcher to a task
Inputs: task_id (required), watcher_id (required).
create_chat_view_commentC
Post a comment to a Chat view
Inputs: view_id (required), comment_text (required), notify_all.
create_checklistC
Add a checklist to a task
Inputs: name (required), task_id (required), team_id, custom_task_ids.
create_checklist_itemC
Add an item to a checklist
Inputs: name (required), checklist_id (required), assignee.
create_folderC
Create a new folder in a space
Inputs: name (required), space_id (required).
create_folderless_listB
Create a new list directly in a space (no folder)
Inputs: name (required), space_id (required), status, content, +3 more.
create_goalC
Create a new goal in a workspace
Inputs: name (required), team_id (required), due_date (required), color, +3 more.
create_key_resultB
Add a key result (target) to a goal
Inputs: name (required), type (required), owners (required), goal_id (required), +5 more.
create_listC
Create a new list in a folder
Inputs: name (required), folder_id (required), status, content, +3 more.
create_list_commentC
Add a comment to a list
Inputs: list_id (required), comment_text (required), assignee, notify_all.
create_spaceB
Create a new space in a workspace
Inputs: name (required), team_id (required), features, multiple_assignees.
create_space_tagC
Create a new tag in a space
Inputs: name (required), space_id (required), tag_bg, tag_fg.
create_taskC
Create a new task in a list
Inputs: name (required), list_id (required), tags, parent, +15 more.
create_task_commentB
Add a comment to a task
Inputs: task_id (required), comment_text (required), assignee, notify_all.
create_threaded_commentC
Reply to an existing comment
Inputs: comment_id (required), comment_text (required), notify_all.
create_time_entryC
Log a time entry for a task
Inputs: start (required), team_id (required), stop, tags, +5 more.
create_webhookB
Create a webhook to receive real-time ClickUp events
Inputs: events (required), team_id (required), endpoint (required), list_id, +3 more.
delete_checklistB
Delete a checklist from a task
Inputs: checklist_id (required).
delete_checklist_itemB
Delete an item from a checklist
Inputs: checklist_id (required), checklist_item_id (required).
delete_commentC
Delete a comment
Inputs: comment_id (required).
delete_folderC
Delete a folder permanently
Inputs: folder_id (required).
delete_goalC
Delete a goal
Inputs: goal_id (required).
delete_key_resultC
Delete a key result from a goal
Inputs: key_result_id (required).
delete_listB
Delete a list permanently
Inputs: list_id (required).
delete_spaceC
Delete a space permanently
Inputs: space_id (required).
delete_space_tagC
Delete a tag from a space
Inputs: space_id (required), tag_name (required).
delete_taskC
Delete a task permanently
Inputs: task_id (required), team_id, custom_task_ids.
delete_task_dependencyC
Remove a dependency between tasks
Inputs: task_id (required), depends_on, dependency_of.
delete_time_entryC
Delete one or more time entries
Inputs: team_id (required), timer_ids (required).
delete_viewC
Delete a view
Inputs: view_id (required).
delete_webhookC
Delete a webhook
Inputs: webhook_id (required).
duplicate_taskC
Duplicate a task into a list
Inputs: list_id (required), task_id (required).
get_authorized_userA
Get the currently authenticated user's profile
Inputs: no named parameters.
get_chat_view_commentsC
Get comments from a Chat view
Inputs: view_id (required), start, start_id.
get_custom_task_typesB
Get all custom task types for a workspace
Inputs: team_id (required).
get_filtered_team_tasksC
Get tasks across a workspace with advanced filters
Inputs: team_id (required), page, tags, reverse, +14 more.
get_folderC
Get details of a specific folder
Inputs: folder_id (required).
get_folderless_listsB
Get all lists that are not in any folder (directly in a space)
Inputs: space_id (required), archived.
get_foldersC
Get all folders in a space
Inputs: space_id (required), archived.
get_folder_viewsC
Get all views for a folder
Inputs: folder_id (required).
get_goalC
Get details of a specific goal
Inputs: goal_id (required).
get_goalsC
Get all goals for a workspace
Inputs: team_id (required), include_completed.
get_guestB
Get details of a guest user in a workspace
Inputs: team_id (required), guest_id (required).
get_listC
Get details of a specific list
Inputs: list_id (required).
get_list_commentsC
Get all comments on a list
Inputs: list_id (required), start, start_id.
get_list_custom_fieldsC
Get all custom fields available for a list
Inputs: list_id (required).
get_list_membersC
Get all members of a list
Inputs: list_id (required).
get_listsC
Get all lists in a folder
Inputs: folder_id (required), archived.
get_list_viewsC
Get all views for a list
Inputs: list_id (required).
get_running_timerB
Get the currently running timer for the authenticated user
Inputs: team_id (required), assignee.
get_spaceC
Get details of a specific space
Inputs: space_id (required).
get_space_membersC
Get all members of a space
Inputs: space_id (required).
get_spacesB
Get all spaces in a workspace
Inputs: team_id (required), archived.
get_space_tagsC
Get all tags defined in a space
Inputs: space_id (required).
get_space_viewsB
Get all views for a space
Inputs: space_id (required).
get_taskC
Get details of a specific task
Inputs: task_id (required), team_id, custom_task_ids, include_subtasks.
get_task_commentsC
Get all comments on a task
Inputs: task_id (required), start, team_id, start_id, +1 more.
get_task_membersB
Get all members of a task
Inputs: task_id (required).
get_tasksC
Get tasks from a list with optional filters
Inputs: list_id (required), page, tags, reverse, +13 more.
get_task_watchersC
Get all watchers of a task
Inputs: task_id (required).
get_threaded_commentsC
Get threaded replies on a comment
Inputs: comment_id (required), start, start_id.
get_time_entriesC
Get time entries for a workspace with optional filters
Inputs: team_id (required), list_id, task_id, assignee, +7 more.
get_time_entryC
Get a single time entry
Inputs: team_id (required), timer_id (required).
get_time_entry_tagsB
Get all time entry tags for a workspace
Inputs: team_id (required).
get_viewB
Get details of a specific view
Inputs: view_id (required).
get_view_tasksC
Get tasks visible in a specific view
Inputs: view_id (required), page.
get_webhooksC
Get all webhooks for a workspace
Inputs: team_id (required).
get_workspaceA
Get details of a specific workspace by team ID
Inputs: team_id (required).
get_workspace_membersC
Get all members of a workspace
Inputs: team_id (required).
get_workspace_planC
Get the current plan for a workspace
Inputs: team_id (required).
get_workspacesA
List all workspaces (teams) the authenticated user belongs to
Inputs: no named parameters.
get_workspace_viewsB
Get all views for a workspace (Everything level)
Inputs: team_id (required).
invite_guest_to_workspaceC
Invite a guest user to a workspace
Inputs: email (required), team_id (required), can_edit_tags, custom_role_id, +4 more.
move_task_to_listB
Move a task to a different list
Inputs: list_id (required), task_id (required).
remove_custom_field_valueA
Remove/clear the value of a custom field on a task
Inputs: task_id (required), field_id (required).
remove_guest_from_workspaceC
Remove a guest user from a workspace
Inputs: team_id (required), guest_id (required).
remove_tag_from_taskC
Remove a tag from a task
Inputs: task_id (required), tag_name (required).
remove_task_linkB
Remove a link between two tasks
Inputs: task_id (required), links_to (required).
remove_task_watcherA
Remove a watcher from a task
Inputs: task_id (required), watcher_id (required).
set_custom_field_valueC
Set the value of a custom field on a task
Inputs: task_id (required), field_id (required), value.
start_timerC
Start a running timer on a task
Inputs: team_id (required), tags, task_id, billable, +1 more.
stop_timerC
Stop the currently running timer for the authenticated user
Inputs: team_id (required).
update_checklistB
Rename or reorder a checklist
Inputs: checklist_id (required), name, position.
update_checklist_itemC
Update a checklist item (rename, check/uncheck, reassign, reorder)
Inputs: checklist_id (required), checklist_item_id (required), name, parent, +2 more.
update_commentC
Edit an existing comment
Inputs: comment_id (required), assignee, resolved, comment_text.
update_folderC
Rename or archive a folder
Inputs: folder_id (required), name, archived.
update_goalC
Update an existing goal
Inputs: goal_id (required), name, color, due_date, +3 more.
update_key_resultC
Update a key result's progress or details
Inputs: key_result_id (required), note, steps_current.
update_listC
Update an existing list
Inputs: list_id (required), name, content, assignee, +4 more.
update_spaceC
Update an existing space
Inputs: space_id (required), name, color, private, +3 more.
update_space_tagC
Update a tag in a space
Inputs: space_id (required), tag_name (required), name, tag_bg, +1 more.
update_taskC
Update an existing task
Inputs: task_id (required), name, parent, status, +11 more.
update_time_entryC
Update a time entry
Inputs: team_id (required), timer_id (required), end, tags, +6 more.
update_webhookC
Update a webhook's endpoint or event subscriptions
Inputs: webhook_id (required), events, status, endpoint.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 97 tools
Most tools target distinct resource-action pairs (e.g., create_space vs create_list vs create_folder are clearly different). A few potential overlaps exist: get_time_entries vs create_time_entry vs start_timer manage similar data, and get_task_watchers/add_task_watcher overlap with task membership. Overall boundaries are mostly clear.
The vast majority follow a consistent verb_noun pattern (e.g., create_space, update_task, delete_comment, get_lists). Minor deviations exist: get_folderless_lists, get_filtered_team_tasks, and set_custom_field_value break the simple verb_noun form but are still readable and logical.
97 tools is far too many for most agentic use cases, despite ClickUp's broad surface. The count exceeds the heavy threshold (25+) by a wide margin, and the score reflects that the surface is bloated even if ClickUp genuinely offers this many operations.
The coverage is remarkably comprehensive: full CRUD across workspaces, spaces, folders, lists, tasks, comments, time entries, goals, key results, checklists, tags, views, webhooks, guests, and custom fields. There are essentially no dead ends—everything from creation through deletion is covered.
Related MCP Connectors
Unofficial ClickUp MCP — wraps the ClickUp REST API v2 (BYO API key)
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Unofficial community ClickUp MCP via personal API token. Not affiliated with ClickUp.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables integration with ClickUp project management platform through a Model Context Protocol server, providing tooling for task management, workspace operations, and team collaboration with flexible authentication and deployment options.151 npm-
- AlicenseBqualityBmaintenanceLightweight ClickUp MCP server for task management with 37 tools and token-optimized responses to reduce API verbosity.40146 npm4MIT
- AlicenseNot gradedqualityBmaintenanceMCP server enabling AI assistants to interact with ClickUp workspaces, including task management, comments, time tracking, and document operations.85 npmMIT
- AlicenseAqualityCmaintenanceA comprehensive MCP server for the ClickUp API exposing 166 tools to manage Spaces, Folders, Lists, Tasks, Docs, and more, enabling LLMs to read and drive a ClickUp Workspace.10046 PyPI1Apache 2.0