ClickUp MCP by usefulapi
Read teams, spaces, lists and tasks; create, update and comment on tasks and track time.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"clickup": {
"url": "https://clickup.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://clickup.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (14)
🟢clickup_get_authorized_user
Get the user associated with the current ClickUp API token. ClickUp REST: GET /user.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_list_workspaces
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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_list_spaces(team_id, archived)
List spaces in a workspace (team). ClickUp REST: GET /team/{team_id}/space.
Eingabe-Schema
{
"type": "object",
"properties": {
"team_id": {
"type": "string",
"description": "The workspace (team) id."
},
"archived": {
"description": "Include archived items — serialized as archived=true/false. Default false.",
"type": "boolean"
}
},
"required": [
"team_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_list_folders(space_id, archived)
List folders in a space. ClickUp REST: GET /space/{space_id}/folder.
Eingabe-Schema
{
"type": "object",
"properties": {
"space_id": {
"type": "string",
"description": "The space id."
},
"archived": {
"description": "Include archived items — serialized as archived=true/false. Default false.",
"type": "boolean"
}
},
"required": [
"space_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_list_lists(folder_id, archived)
List the lists inside a folder. ClickUp REST: GET /folder/{folder_id}/list.
Eingabe-Schema
{
"type": "object",
"properties": {
"folder_id": {
"type": "string",
"description": "The folder id."
},
"archived": {
"description": "Include archived items — serialized as archived=true/false. Default false.",
"type": "boolean"
}
},
"required": [
"folder_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_list_folderless_lists(space_id, archived)
List the lists that live directly in a space (not inside a folder). ClickUp REST: GET /space/{space_id}/list.
Eingabe-Schema
{
"type": "object",
"properties": {
"space_id": {
"type": "string",
"description": "The space id."
},
"archived": {
"description": "Include archived items — serialized as archived=true/false. Default false.",
"type": "boolean"
}
},
"required": [
"space_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_get_tasks(list_id, archived, page, order_by, reverse, ...)
Get the tasks in a list, with optional filters and pagination. ClickUp REST: GET /list/{list_id}/task.
Eingabe-Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string",
"description": "The list id."
},
"archived": {
"description": "Include archived items — serialized as archived=true/false. Default false.",
"type": "boolean"
},
"page": {
"description": "0-indexed page number for pagination.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"order_by": {
"description": "Sort field, e.g. 'created', 'updated', 'due_date', 'id'.",
"type": "string"
},
"reverse": {
"description": "Reverse the sort order (serialized true/false).",
"type": "boolean"
},
"subtasks": {
"description": "Include subtasks (serialized true/false).",
"type": "boolean"
},
"statuses": {
"description": "Filter by status names (repeated statuses[] params), e.g. [\"open\",\"in progress\"].",
"type": "array",
"items": {
"type": "string"
}
},
"include_closed": {
"description": "Include closed tasks (serialized true/false).",
"type": "boolean"
},
"assignees": {
"description": "Filter by assignee user ids (repeated assignees[] params).",
"type": "array",
"items": {
"type": "string"
}
},
"due_date_gt": {
"description": "Only tasks due after this Unix time in ms.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"due_date_lt": {
"description": "Only tasks due before this Unix time in ms.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"list_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_get_task(task_id, include_subtasks)
Get a single task by id. ClickUp REST: GET /task/{task_id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "The task id."
},
"include_subtasks": {
"description": "Include the task's subtasks (serialized true/false).",
"type": "boolean"
}
},
"required": [
"task_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_get_task_comments(task_id)
Get the comments on a task. ClickUp REST: GET /task/{task_id}/comment.
Eingabe-Schema
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "The task id."
}
},
"required": [
"task_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_get_list_comments(list_id)
Get the comments on a list. ClickUp REST: GET /list/{list_id}/comment.
Eingabe-Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string",
"description": "The list id."
}
},
"required": [
"list_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clickup_search_tasks(team_id, page, order_by, reverse, statuses, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"team_id": {
"type": "string",
"description": "The workspace (team) id."
},
"page": {
"description": "0-indexed page number for pagination.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"order_by": {
"description": "Sort field, e.g. 'created', 'updated', 'due_date', 'id'.",
"type": "string"
},
"reverse": {
"description": "Reverse the sort order (serialized true/false).",
"type": "boolean"
},
"statuses": {
"description": "Filter by status names (repeated statuses[] params), e.g. [\"open\",\"in progress\"].",
"type": "array",
"items": {
"type": "string"
}
},
"assignees": {
"description": "Filter by assignee user ids (repeated assignees[] params).",
"type": "array",
"items": {
"type": "string"
}
},
"include_closed": {
"description": "Include closed tasks (serialized true/false).",
"type": "boolean"
},
"space_ids": {
"description": "Restrict to these space ids (repeated space_ids[] params).",
"type": "array",
"items": {
"type": "string"
}
},
"project_ids": {
"description": "Restrict to these folder/project ids (repeated project_ids[] params).",
"type": "array",
"items": {
"type": "string"
}
},
"list_ids": {
"description": "Restrict to these list ids (repeated list_ids[] params).",
"type": "array",
"items": {
"type": "string"
}
},
"due_date_gt": {
"description": "Only tasks due after this Unix time in ms.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"due_date_lt": {
"description": "Only tasks due before this Unix time in ms.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"team_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clickup_create_task(list_id, name, description, assignees, status, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string",
"description": "The list id to create the task in (path param, not body)."
},
"name": {
"type": "string",
"description": "The task name (required)."
},
"description": {
"description": "The task description / body text.",
"type": "string"
},
"assignees": {
"description": "User ids to assign the task to (numeric).",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"status": {
"description": "Status name (must be a valid status in the list).",
"type": "string"
},
"priority": {
"description": "Task priority: 1=Urgent, 2=High, 3=Normal, 4=Low.",
"type": "integer",
"minimum": 1,
"maximum": 4
},
"due_date": {
"description": "Due date as Unix time in ms.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"due_date_time": {
"description": "Whether due_date carries a time component (else date-only).",
"type": "boolean"
},
"start_date": {
"description": "Start date as Unix time in ms.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"tags": {
"description": "Tag names to attach.",
"type": "array",
"items": {
"type": "string"
}
},
"parent": {
"description": "Parent task id — set to create this task as a subtask.",
"type": "string"
}
},
"required": [
"list_id",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clickup_update_task(task_id, name, description, status, priority, ...)
WRITE: update fields on an existing task. Only the fields you pass are changed. ClickUp REST: PUT /task/{task_id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "The task id to update (path param, not body)."
},
"name": {
"description": "New task name.",
"type": "string"
},
"description": {
"description": "New task description / body text.",
"type": "string"
},
"status": {
"description": "New status name (must be valid for the list).",
"type": "string"
},
"priority": {
"description": "Task priority: 1=Urgent, 2=High, 3=Normal, 4=Low.",
"type": "integer",
"minimum": 1,
"maximum": 4
},
"due_date": {
"description": "Due date as Unix time in ms.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"due_date_time": {
"description": "Whether due_date carries a time component (else date-only).",
"type": "boolean"
},
"start_date": {
"description": "Start date as Unix time in ms.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"archived": {
"description": "Archive (true) or unarchive (false) the task.",
"type": "boolean"
},
"parent": {
"description": "Parent task id (re-parent as a subtask).",
"type": "string"
}
},
"required": [
"task_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clickup_create_task_comment(task_id, comment_text, assignee, notify_all)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "The task id to comment on (path param, not body)."
},
"comment_text": {
"type": "string",
"description": "The comment text (required)."
},
"assignee": {
"description": "User id to assign the comment to (numeric).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"notify_all": {
"description": "If true, notify everyone tagged/subscribed (else just the assignee).",
"type": "boolean"
}
},
"required": [
"task_id",
"comment_text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis