ClickUp MCP by usefulapi is an MCP server published by io.usefulapi, hosted at clickup.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 14 tools, including clickup_get_authorized_user, clickup_list_workspaces, clickup_list_spaces, clickup_list_folders, clickup_list_lists.
Read teams, spaces, lists and tasks; create, update and comment on tasks and track time.
4,171 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the user associated with the current ClickUp API token. ClickUp REST: GET /user.
No parameters.
{
"name": "clickup_get_authorized_user",
"title": "Get authorized user",
"description": "Get the user associated with the current ClickUp API token. ClickUp REST: GET /user.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get authorized user",
"readOnlyHint": true
}
}List the workspaces (the ClickUp API calls these "teams") the token can access — their ids are the team_id used by other tools. ClickUp REST: GET /team.
No parameters.
{
"name": "clickup_list_workspaces",
"title": "List workspaces",
"description": "List the workspaces (the ClickUp API calls these \"teams\") the token can access — their ids are the team_id used by other tools. ClickUp REST: GET /team.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List workspaces",
"readOnlyHint": true
}
}List spaces in a workspace (team). ClickUp REST: GET /team/{team_id}/space.
| Parameter | Type | Description |
|---|---|---|
| team_id * | string | The workspace (team) id. |
| archived | boolean | Include archived items — serialized as archived=true/false. Default false. |
{
"name": "clickup_list_spaces",
"title": "List spaces",
"description": "List spaces in a workspace (team). ClickUp REST: GET /team/{team_id}/space.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"team_id"
],
"properties": {
"team_id": {
"type": "string",
"description": "The workspace (team) id."
},
"archived": {
"type": "boolean",
"description": "Include archived items — serialized as archived=true/false. Default false."
}
}
},
"annotations": {
"title": "List spaces",
"readOnlyHint": true
}
}List folders in a space. ClickUp REST: GET /space/{space_id}/folder.
| Parameter | Type | Description |
|---|---|---|
| archived | boolean | Include archived items — serialized as archived=true/false. Default false. |
| space_id * | string | The space id. |
{
"name": "clickup_list_folders",
"title": "List folders",
"description": "List folders in a space. ClickUp REST: GET /space/{space_id}/folder.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id"
],
"properties": {
"archived": {
"type": "boolean",
"description": "Include archived items — serialized as archived=true/false. Default false."
},
"space_id": {
"type": "string",
"description": "The space id."
}
}
},
"annotations": {
"title": "List folders",
"readOnlyHint": true
}
}List the lists inside a folder. ClickUp REST: GET /folder/{folder_id}/list.
| Parameter | Type | Description |
|---|---|---|
| archived | boolean | Include archived items — serialized as archived=true/false. Default false. |
| folder_id * | string | The folder id. |
{
"name": "clickup_list_lists",
"title": "List lists",
"description": "List the lists inside a folder. ClickUp REST: GET /folder/{folder_id}/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"folder_id"
],
"properties": {
"archived": {
"type": "boolean",
"description": "Include archived items — serialized as archived=true/false. Default false."
},
"folder_id": {
"type": "string",
"description": "The folder id."
}
}
},
"annotations": {
"title": "List lists",
"readOnlyHint": true
}
}List the lists that live directly in a space (not inside a folder). ClickUp REST: GET /space/{space_id}/list.
| Parameter | Type | Description |
|---|---|---|
| archived | boolean | Include archived items — serialized as archived=true/false. Default false. |
| space_id * | string | The space id. |
{
"name": "clickup_list_folderless_lists",
"title": "List folderless lists",
"description": "List the lists that live directly in a space (not inside a folder). ClickUp REST: GET /space/{space_id}/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id"
],
"properties": {
"archived": {
"type": "boolean",
"description": "Include archived items — serialized as archived=true/false. Default false."
},
"space_id": {
"type": "string",
"description": "The space id."
}
}
},
"annotations": {
"title": "List folderless lists",
"readOnlyHint": true
}
}Get the tasks in a list, with optional filters and pagination. ClickUp REST: GET /list/{list_id}/task.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 0-indexed page number for pagination. |
| list_id * | string | The list id. |
| reverse | boolean | Reverse the sort order (serialized true/false). |
| archived | boolean | Include archived items — serialized as archived=true/false. Default false. |
| order_by | string | Sort field, e.g. 'created', 'updated', 'due_date', 'id'. |
| statuses | array | Filter by status names (repeated statuses[] params), e.g. ["open","in progress"]. |
| subtasks | boolean | Include subtasks (serialized true/false). |
| assignees | array | Filter by assignee user ids (repeated assignees[] params). |
| due_date_gt | integer | Only tasks due after this Unix time in ms. |
| due_date_lt | integer | Only tasks due before this Unix time in ms. |
| include_closed |
Get a single task by id. ClickUp REST: GET /task/{task_id}.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | The task id. |
| include_subtasks | boolean | Include the task's subtasks (serialized true/false). |
{
"name": "clickup_get_task",
"title": "Get task",
"description": "Get a single task by id. ClickUp REST: GET /task/{task_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task id."
},
"include_subtasks": {
"type": "boolean",
"description": "Include the task's subtasks (serialized true/false)."
}
}
},
"annotations": {
"title": "Get task",
"readOnlyHint": true
}
}Get the comments on a task. ClickUp REST: GET /task/{task_id}/comment.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | The task id. |
{
"name": "clickup_get_task_comments",
"title": "Get task comments",
"description": "Get the comments on a task. ClickUp REST: GET /task/{task_id}/comment.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task id."
}
}
},
"annotations": {
"title": "Get task comments",
"readOnlyHint": true
}
}Get the comments on a list. ClickUp REST: GET /list/{list_id}/comment.
| Parameter | Type | Description |
|---|---|---|
| list_id * | string | The list id. |
{
"name": "clickup_get_list_comments",
"title": "Get list comments",
"description": "Get the comments on a list. ClickUp REST: GET /list/{list_id}/comment.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"type": "string",
"description": "The list id."
}
}
},
"annotations": {
"title": "Get list comments",
"readOnlyHint": true
}
}Search/filter tasks across a whole workspace (team), optionally scoped to spaces/folders/lists. ClickUp's "Get Filtered Team Tasks". ClickUp REST: GET /team/{team_id}/task.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 0-indexed page number for pagination. |
| reverse | boolean | Reverse the sort order (serialized true/false). |
| team_id * | string | The workspace (team) id. |
| list_ids | array | Restrict to these list ids (repeated list_ids[] params). |
| order_by | string | Sort field, e.g. 'created', 'updated', 'due_date', 'id'. |
| statuses | array | Filter by status names (repeated statuses[] params), e.g. ["open","in progress"]. |
| assignees | array | Filter by assignee user ids (repeated assignees[] params). |
| space_ids | array | Restrict to these space ids (repeated space_ids[] params). |
| due_date_gt | integer | Only tasks due after this Unix time in ms. |
| due_date_lt | integer | Only tasks due before this Unix time in ms. |
WRITE: create a new task in a list. `name` is required; the list is the {list_id} path param, not a body field. ClickUp REST: POST /list/{list_id}/task.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The task name (required). |
| tags | array | Tag names to attach. |
| parent | string | Parent task id — set to create this task as a subtask. |
| status | string | Status name (must be a valid status in the list). |
| list_id * | string | The list id to create the task in (path param, not body). |
| due_date | integer | Due date as Unix time in ms. |
| priority | integer | Task priority: 1=Urgent, 2=High, 3=Normal, 4=Low. |
| assignees | array | User ids to assign the task to (numeric). |
| start_date | integer | Start date as Unix time in ms. |
| description | string | The task description / body text. |
| due_date_time |
WRITE: update fields on an existing task. Only the fields you pass are changed. ClickUp REST: PUT /task/{task_id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | New task name. |
| parent | string | Parent task id (re-parent as a subtask). |
| status | string | New status name (must be valid for the list). |
| task_id * | string | The task id to update (path param, not body). |
| archived | boolean | Archive (true) or unarchive (false) the task. |
| due_date | integer | Due date as Unix time in ms. |
| priority | integer | Task priority: 1=Urgent, 2=High, 3=Normal, 4=Low. |
| start_date | integer | Start date as Unix time in ms. |
| description | string | New task description / body text. |
| due_date_time | boolean | Whether due_date carries a time component (else date-only). |
WRITE: add a comment to a task. `comment_text` is required; the task is the {task_id} path param. ClickUp REST: POST /task/{task_id}/comment.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | The task id to comment on (path param, not body). |
| assignee | integer | User id to assign the comment to (numeric). |
| notify_all | boolean | If true, notify everyone tagged/subscribed (else just the assignee). |
| comment_text * | string | The comment text (required). |
{
"name": "clickup_create_task_comment",
"title": "Create task comment",
"description": "WRITE: add a comment to a task. `comment_text` is required; the task is the {task_id} path param. ClickUp REST: POST /task/{task_id}/comment.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id",
"comment_text"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task id to comment on (path param, not body)."
},
"assignee": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "User id to assign the comment to (numeric)."
},
"notify_all": {
"type": "boolean",
"description": "If true, notify everyone tagged/subscribed (else just the assignee)."
},
"comment_text": {
"type": "string",
"description": "The comment text (required)."
}
}
},
"annotations": {
"title": "Create task comment",
"destructiveHint": true
}
}Tools for ClickUp, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "List all tasks assigned to me in my Marketing list."; "Which tasks across my workspace are due this week?"; "Show tasks in my Marketing list so I can choose one to read its comments.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes ClickUp data. Free plan: 50 tool calls per month. Run clickup_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run clickup_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run clickup_upgrade without a plan: it returns both plans, each with a payment link for the user to open. clickup_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| boolean |
| Include closed tasks (serialized true/false). |
{
"name": "clickup_get_tasks",
"title": "Get tasks",
"description": "Get the tasks in a list, with optional filters and pagination. ClickUp REST: GET /list/{list_id}/task.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "0-indexed page number for pagination."
},
"list_id": {
"type": "string",
"description": "The list id."
},
"reverse": {
"type": "boolean",
"description": "Reverse the sort order (serialized true/false)."
},
"archived": {
"type": "boolean",
"description": "Include archived items — serialized as archived=true/false. Default false."
},
"order_by": {
"type": "string",
"description": "Sort field, e.g. 'created', 'updated', 'due_date', 'id'."
},
"statuses": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by status names (repeated statuses[] params), e.g. [\"open\",\"in progress\"]."
},
"subtasks": {
"type": "boolean",
"description": "Include subtasks (serialized true/false)."
},
"assignees": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by assignee user ids (repeated assignees[] params)."
},
"due_date_gt": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only tasks due after this Unix time in ms."
},
"due_date_lt": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only tasks due before this Unix time in ms."
},
"include_closed": {
"type": "boolean",
"description": "Include closed tasks (serialized true/false)."
}
}
},
"annotations": {
"title": "Get tasks",
"readOnlyHint": true
}
}| project_ids | array | Restrict to these folder/project ids (repeated project_ids[] params). |
| include_closed | boolean | Include closed tasks (serialized true/false). |
{
"name": "clickup_search_tasks",
"title": "Search tasks",
"description": "Search/filter tasks across a whole workspace (team), optionally scoped to spaces/folders/lists. ClickUp's \"Get Filtered Team Tasks\". ClickUp REST: GET /team/{team_id}/task.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"team_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "0-indexed page number for pagination."
},
"reverse": {
"type": "boolean",
"description": "Reverse the sort order (serialized true/false)."
},
"team_id": {
"type": "string",
"description": "The workspace (team) id."
},
"list_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Restrict to these list ids (repeated list_ids[] params)."
},
"order_by": {
"type": "string",
"description": "Sort field, e.g. 'created', 'updated', 'due_date', 'id'."
},
"statuses": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by status names (repeated statuses[] params), e.g. [\"open\",\"in progress\"]."
},
"assignees": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by assignee user ids (repeated assignees[] params)."
},
"space_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Restrict to these space ids (repeated space_ids[] params)."
},
"due_date_gt": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only tasks due after this Unix time in ms."
},
"due_date_lt": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only tasks due before this Unix time in ms."
},
"project_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Restrict to these folder/project ids (repeated project_ids[] params)."
},
"include_closed": {
"type": "boolean",
"description": "Include closed tasks (serialized true/false)."
}
}
},
"annotations": {
"title": "Search tasks",
"readOnlyHint": true
}
}| boolean |
| Whether due_date carries a time component (else date-only). |
{
"name": "clickup_create_task",
"title": "Create task",
"description": "WRITE: create a new task in a list. `name` is required; the list is the {list_id} path param, not a body field. ClickUp REST: POST /list/{list_id}/task.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The task name (required)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tag names to attach."
},
"parent": {
"type": "string",
"description": "Parent task id — set to create this task as a subtask."
},
"status": {
"type": "string",
"description": "Status name (must be a valid status in the list)."
},
"list_id": {
"type": "string",
"description": "The list id to create the task in (path param, not body)."
},
"due_date": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Due date as Unix time in ms."
},
"priority": {
"type": "integer",
"maximum": 4,
"minimum": 1,
"description": "Task priority: 1=Urgent, 2=High, 3=Normal, 4=Low."
},
"assignees": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "User ids to assign the task to (numeric)."
},
"start_date": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Start date as Unix time in ms."
},
"description": {
"type": "string",
"description": "The task description / body text."
},
"due_date_time": {
"type": "boolean",
"description": "Whether due_date carries a time component (else date-only)."
}
}
},
"annotations": {
"title": "Create task",
"destructiveHint": true
}
}{
"name": "clickup_update_task",
"title": "Update task",
"description": "WRITE: update fields on an existing task. Only the fields you pass are changed. ClickUp REST: PUT /task/{task_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"name": {
"type": "string",
"description": "New task name."
},
"parent": {
"type": "string",
"description": "Parent task id (re-parent as a subtask)."
},
"status": {
"type": "string",
"description": "New status name (must be valid for the list)."
},
"task_id": {
"type": "string",
"description": "The task id to update (path param, not body)."
},
"archived": {
"type": "boolean",
"description": "Archive (true) or unarchive (false) the task."
},
"due_date": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Due date as Unix time in ms."
},
"priority": {
"type": "integer",
"maximum": 4,
"minimum": 1,
"description": "Task priority: 1=Urgent, 2=High, 3=Normal, 4=Low."
},
"start_date": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Start date as Unix time in ms."
},
"description": {
"type": "string",
"description": "New task description / body text."
},
"due_date_time": {
"type": "boolean",
"description": "Whether due_date carries a time component (else date-only)."
}
}
},
"annotations": {
"title": "Update task",
"destructiveHint": true
}
}