# ClickUp

Manage projects, tasks, and documents directly through a comprehensive suite of productivity tools. Search for tasks, generate status reports, and track time entries across entire workspaces. Access …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add Polaralias/clickup-mcp

# Browse available tools
npx -y smithery tool list Polaralias/clickup-mcp

# Get full schema for a tool
npx -y smithery tool get Polaralias/clickup-mcp ping

# Call a tool
npx -y smithery tool call Polaralias/clickup-mcp ping '{}'
```

## Direct MCP Connection

Endpoint: `https://clickup-mcp--polaralias.run.tools`

**Required config:**
- `apiKey` (query) — ClickUp personal API token used for all API requests
- `readOnly` (query) — When true, all write operations are disabled. Takes precedence over other write settings.
- `charLimit` (query) — Maximum characters returned before responses are truncated
- `selectiveWrite` (query) — When true, write access is restricted to specific lists or spaces defined in writeLists and writeSpaces.
- `maxAttachmentMb` (query) — Largest file attachment (MB) allowed for uploads
- `reportingMaxTasks` (query) — Max tasks to fetch for reports
- `hierarchyCacheTtlMs` (query) — Hierarchy cache TTL in milliseconds
- `defaultRiskWindowDays` (query) — Default window for risk reports
- `spaceConfigCacheTtlMs` (query) — Space config cache TTL in milliseconds

**Optional config:**
- `teamId` (query) — ClickUp workspace ID applied when tool inputs omit one
- `writeMode` (query) — Explicit write mode configuration

## Tools (41)

- `ping` — Echo request for connectivity checks.
- `health` — Report server readiness and enforced safety limits.
- `tool_catalogue` — Enumerate all available tools with their annotations.
- `workspace_capability_snapshot` — Expose cached ClickUp capability probes for this session.
- `workspace_list` — List accessible ClickUp workspaces (teams). Use when you need workspace IDs before exploring spaces.
- `space_list_for_workspace` — List spaces for a workspace by workspaceId. Use search when you only know workspace names.
- `folder_list_for_space` — List folders within a ClickUp space. Use when you already know spaceId.
- `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_ids.
- `workspace_overview` — Summarise workspace metrics and recent spaces/folders/lists when you have a workspaceId.
- `workspace_hierarchy` — Fetch nested hierarchy (spaces, folders, lists) for one or more workspaces. Use this to browse structure without task d…
- `hierarchy_resolve_path` — Resolve workspace/space/folder/list names into IDs. Use before tools that require IDs.
- `member_list_for_workspace` — List members in a workspace by teamId. Use when you already know the workspaceId.
- `member_resolve` — Resolve member identifiers (id, email, username) into member records for a workspace.
- `member_search_by_name` — Fuzzy search member names to find member IDs.
- `task_assignee_resolve` — Translate assignee references into suggested member IDs for tasks.
- `space_tag_list` — List tags configured for a space using spaceId.
- `reference_link_list` — List public ClickUp API reference links.
- `reference_page_fetch` — Fetch a public ClickUp API reference page from a link returned by reference_link_list.
- `task_search` — Structured task search with filters. Use when you have listIds/tagIds; returns tasks across lists.
- `task_search_fuzzy` — Fuzzy task search from natural language when you do not have precise filters.
- `task_search_fuzzy_bulk` — Batch fuzzy task searches for multiple natural language prompts.
- `task_status_report` — Summarise task status and priority for a workspace, space, folder or list without returning full task lists.
- `task_risk_report` — Summarise overdue and at-risk tasks within a workspace, space, folder or list. Subtasks are included by default; use in…
- `task_read` — Fetch task details including createdDate/updatedDate fields derived from ClickUp timestamps. Subtask cues (isSubtask, p…
- `task_list_for_list` — List tasks in a list. Tasks linked from other lists are included by default (include_timl=true). Outputs include create…
- `task_comment_list` — Retrieve task comments for a taskId.
- `list_custom_field_list` — List custom fields configured for a list by listId.
- `doc_list` — List documents within a workspace using filters.
- `doc_read` — Fetch document metadata and pages for a docId.
- `doc_pages_read` — Fetch selected document pages by docId and pageIds.
- `doc_page_list` — List page hierarchy for a document by docId.
- `doc_page_read` — Fetch a single document page by docId and pageId.
- `doc_search` — Search document content across a workspace. Use doc_page_read for specific pages.
- `doc_search_bulk` — Batch document searches when you need several queries processed together.
- `task_time_entry_list` — Fetch time entries for a taskId, including total duration.
- `time_entry_current` — Retrieve the current running timer for the workspace.
- `time_entry_list` — List time entries with filters. Accepts ISO 8601 or epoch boundaries; include taskId when focusing on a single task.
- `time_report_for_tag` — Aggregate logged time for a tag across the workspace. Use space_tag_list to discover tags, and includeSubtasks to contr…
- `time_report_for_container` — Aggregate time for a workspace, space, folder or list using containerId + containerType. Resolve IDs with resolve_path_…
- `time_report_for_context` — Aggregate time for a task, list (including filtered views), space or workspace. Use search_tasks or task_list_for_list …
- `time_report_for_space_tag` — Aggregate time for a tag within a space using spaceId. Use space_tag_list to pick the tag and includeSubtasks to contro…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get Polaralias/clickup-mcp <tool-name>
```