Skip to main content
Glama

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-mcp

3. 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-mcp

Environment Variables

Variable

Required

Description

CLICKUP_API_TOKEN

Yes

Personal API token from ClickUp Settings → Apps

CLICKUP_TEAM_ID

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 dev

License

MIT

Available Tools

97 tools
add_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_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_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

    B3/5.0

    Scored across 97 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    Related MCP Servers