For AI agents — MCPBundles Directory API
For MCP client apps (human connect):
MCP connect URL: https://mcp.mcpbundles.com/bundle/clickup
Skill page: https://www.mcpbundles.com/skills/clickup
Tools: 15
Live probe refreshed Nov 21, 2026 · Endpoint host mcp.mcpbundles.com
AI Skill
SKILL.md
Domain knowledge for ClickUp — workflow patterns, data models, and gotchas for your AI agent.
ClickUp
Project management platform with a strict 5-level hierarchy. Every query requires the parent ID from the level above.
Entity Hierarchy
The hierarchy is rigid: Team → Space → Folder → List → Task. You must walk it top-down because each level's ID is required to query the next.
Teams (workspaces) — top-level container. Enumerate teams first to get team_id. Also scopes goals, custom fields, and time tracking tags.
Users — current authenticated user profile. Separate from team context.
Spaces — project-level containers within a team. Requires team_id. Also scopes tags.
Folders — optional grouping layer within a space. Requires space_id. Can be skipped (folderless lists exist).
Lists — task containers. Requires folder_id (or space_id for folderless lists). Scopes comments, custom fields, and task statuses.
Tasks — individual work items within a list. Requires list_id. Filter by statuses, assignees, and subtasks. Sort with order_by (created/updated/due_date). Use include_closed: true to include completed tasks. Open a task by id for full detail payloads.
Cross-cutting Entities
Comments — attached to lists (by list_id). Task comments are also available.
Custom Fields — defined at team level (global) or list level (local). Query both to see all available fields.
Goals — OKR-style objectives scoped to a team (team_id).
Tags — labels scoped to a space (space_id).
Time Tracking — time entries on tasks (task_id). Time tracking tags are team-scoped.
Workflows
Task discovery: Teams → spaces → folders → lists → tasks (with status/assignee filters) → single-task detail when you need description, dependencies, or custom fields.
Goal review: Teams → team-scoped goals for OKR progress.
Time audit: Teams → time-tracking tags, then tasks, then per-task time entries.
Custom field inventory: Team-wide custom field reads first, then list-scoped definitions for overrides.
Comment review: Lists → list-level comment threads using the list id from the prior step.
Gotchas
Strict parent ID chain: you cannot skip levels. Tasks need list_id; lists need a folder or a folderless list under a space; spaces need team_id.
Folderless lists: many workspaces put lists directly under spaces without folders. When folder listings are empty, enumerate folderless lists for that space_id.
Closed tasks: Task listings hide completed work unless you opt in via include_closed.
Detail vs summary: list responses stay lightweight; open a task by id when you need description, custom fields, dependencies, or estimates.
Custom statuses per list: each list can define its own status workflow. Don't assume status names are consistent across lists.
MCPBundles publishes this directory for MCP discovery. Except where we host or operate an offering, third-party services run under their own terms. Product and company names on this page are used in a descriptive, identifying way (including under nominative fair use where applicable); they remain the property of their owners. Nothing here grants you rights in those marks, and nothing here is an offer to sell a third party's services. Terms
ClickUp
Add to your AI client, then sign in once when you connect.
ClickUp is a project management platform allowing users to manage tasks, projects, and workflows with features like task assignments, timelines, and collaboration tools. It is used to enhance productivity and streamline project execution.
This listing identifies a third-party integration. MCPBundles is not affiliated with, sponsored by, or endorsed by the service or its operator unless stated on this page.
Get all comments on a ClickUp list — returns comment text, author, timestamp, and assignee. Requires 'list_id'. For task-level comments, use task comments API instead.
Clickup Fetch List Comments — Get all comments on a ClickUp list — returns comment text, author, timestamp, and assignee. Requires 'list_id'. For task-level comments, use task comments API instead.
Clickup Fetch Time Tracking — Retrieve all time entries for a specific task to monitor time spent on individual tasks. Use this tool for detailed time tracking analytics. Returns time entry details including duration and timestamps; requires 'task_id'.
Clickup Fetch Time Tracking Tags — Fetch all time tracking tags available for a specified team in ClickUp. Use this tool to categorize and analyze time usage effectively. Returns tag details like tag name and usage metrics; requires 'team_id'.
Clickup Get Task — Get a specific task by ID — full details including title, description, status, priority, assignees, due dates, custom fields, tags, time estimates, and dependencies. Requires 'task_id'.
Clickup List Folder — Fetch all folders within a specific space on ClickUp. Use this to organize your workflows into manageable sections. Returns folder details including folder names and IDs; requires 'space_id' parameter.
Clickup List Folderless List — Get lists that live directly under a space (not inside any folder). Many ClickUp workspaces skip folders entirely — use this when the folders endpoint returns empty. Requires 'space_id'.
Clickup List List — Get a collection of lists from a specified folder within ClickUp. Ideal for organizing tasks under different categories or projects. Returns list details including IDs and names; requires 'folder_id' parameter for specificity.
Clickup List List Custom Fields — Get custom fields associated with a specific list in ClickUp. Useful for accessing additional task attributes tailored to your project's needs. Returns custom field details like field names and types; requires 'list_id'.
Frequently Asked Questions
What is the ClickUp MCP server?
ClickUp is a project management platform allowing users to manage tasks, projects, and workflows with features like task assignments, timelines, and collaboration tools. It is used to enhance productivity and streamline project execution. It provides 15 tools that AI agents can use through the Model Context Protocol (MCP).
How do I connect ClickUp to my AI agent?
Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/clickup. Authentication is handled automatically.
Clickup List Space — List all spaces within a ClickUp workspace — returns space name, ID, status definitions, and feature settings. Requires 'team_id' from list_team.
Clickup List Space Tags — Retrieve all tags available within a specific space in ClickUp. Use this tool when you need an overview of tags for task organization or filtering within the given space. It returns a list of tag objects associated with the specified space, using the 'space_id' parameter to identify the space.
Clickup List Task — List tasks within a ClickUp list — returns task title, status, assignees, priority, due date, and custom fields. Set 'include_closed' to true to include completed/closed tasks. Requires 'list_id'.
Clickup List Team — List all workspaces (teams) accessible with your API token — returns team name, ID, member list, and color. This is always the first call in the ClickUp hierarchy.
Clickup List Team Custom Fields — Retrieve custom fields defined at the team level in ClickUp. Use this to standardize data fields across tasks. Returns custom field configurations such as names and data types; requires 'team_id'.
Clickup List Team Goals — Obtain a list of current goals set by a specific team in ClickUp. This tool is useful for tracking team progress and objectives, ensuring alignment on project goals. It returns goal details for the team identified by the 'team_id' parameter, including title, due date, and progress metrics.
Clickup List User — Get the authenticated user's profile — name, email, and profile information.
ClickUp provides 15 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.
What authentication does ClickUp require?
ClickUp uses API Key. ClickUp requires credentials. Connect via MCPBundles and authentication is handled automatically.
MCPBundles is an independent platform built on the open Model Context Protocol standard. MCPBundles is not affiliated with, sponsored by, or endorsed by Anthropic PBC.
More in project management
Other MCP servers in this category from the directory index