// MCP TOOL REFERENCE

CLICKUP TOOLS

41 tools from the Clickup MCP Server, categorised by risk level.

View the Clickup policy → Token cost: 7,475 tokens →

// ALL 41 CLICKUP TOOLS

READ 36 tools

Read doc_list List documents within a workspace using filters. Read doc_page_list List page hierarchy for a document by docId. Read doc_page_read Fetch a single document page by docId and pageId. Read doc_pages_read Fetch selected document pages by docId and pageIds. Read doc_read Fetch document metadata and pages for a docId. Read doc_search Search document content across a workspace. Use doc_page_read for specific pages. Read doc_search_bulk Batch document searches when you need several queries processed together. Read folder_list_for_space List folders within a ClickUp space. Use when you already know spaceId. Read health Report server readiness and enforced safety limits. Read list_custom_field_list List custom fields configured for a list by listId. Read list_list_for_space_or_folder List lists inside a space or folder by ID. If you only know names, resolve them first with resolve_path_to_... Read member_list_for_workspace List members in a workspace by teamId. Use when you already know the workspaceId. Read member_search_by_name Fuzzy search member names to find member IDs. Read ping Echo request for connectivity checks. Read reference_link_list List public ClickUp API reference links. Read reference_page_fetch Fetch a public ClickUp API reference page from a link returned by reference_link_list. Read space_list_for_workspace List spaces for a workspace by workspaceId. Use search when you only know workspace names. Read space_tag_list List tags configured for a space using spaceId. Read task_list_for_list List tasks in a list. Tasks linked from other lists are included by default (include_timl=true). Outputs in... Read task_read Fetch task details including createdDate/updatedDate fields derived from ClickUp timestamps. Subtask cues (... Read task_risk_report Summarise overdue and at-risk tasks within a workspace, space, folder or list. Subtasks are included by def... Read task_search Structured task search with filters. Use when you have listIds/tagIds; returns tasks across lists. Read task_search_fuzzy Fuzzy task search from natural language when you do not have precise filters. Read task_search_fuzzy_bulk Batch fuzzy task searches for multiple natural language prompts. Read task_status_report Summarise task status and priority for a workspace, space, folder or list without returning full task lists. Read task_time_entry_list Fetch time entries for a taskId, including total duration. Read time_entry_current Retrieve the current running timer for the workspace. Read time_entry_list List time entries with filters. Accepts ISO 8601 or epoch boundaries; include taskId when focusing on a sin... Read time_report_for_context Aggregate time for a task, list (including filtered views), space or workspace. Use search_tasks or task_li... Read time_report_for_space_tag Aggregate time for a tag within a space using spaceId. Use space_tag_list to pick the tag and includeSubtas... Read time_report_for_tag Aggregate logged time for a tag across the workspace. Use space_tag_list to discover tags, and includeSubta... Read tool_catalogue Enumerate all available tools with their annotations. Read workspace_capability_snapshot Expose cached ClickUp capability probes for this session. Read workspace_hierarchy Fetch nested hierarchy (spaces, folders, lists) for one or more workspaces. Use this to browse structure wi... Read workspace_list List accessible ClickUp workspaces (teams). Use when you need workspace IDs before exploring spaces. Read workspace_overview Summarise workspace metrics and recent spaces/folders/lists when you have a workspaceId.

WRITE 5 tools

Write hierarchy_resolve_path Resolve workspace/space/folder/list names into IDs. Use before tools that require IDs. Write member_resolve Resolve member identifiers (id, email, username) into member records for a workspace. Write task_assignee_resolve Translate assignee references into suggested member IDs for tasks. Write task_comment_list Retrieve task comments for a taskId. Write time_report_for_container Aggregate time for a workspace, space, folder or list using containerId + containerType. Resolve IDs with r...

// RUNNING THIS SERVER

The managed route: connect Clickup through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y @taazkareem/clickup-mcp-server

// FAQ

How many tools does the Clickup MCP server have? +

The Clickup MCP server exposes 41 tools across 2 categories: Read, Write.

How do I enforce policies on Clickup tools? +

Route the Clickup server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Clickup tools fall into? +

Clickup tools are categorised as Read (36), Write (5). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.