clickup-mcp
This server integrates ClickUp via the MCP protocol, providing tools to manage workspaces, spaces, folders, lists, tasks, comments, and Docs.
Workspaces: List all available workspaces/teams.
Spaces: List spaces within a workspace and get details of a specific space.
Folders: Create, update, delete, get details, and list folders within a space.
Lists: Create folderless lists in a space, create lists within a folder, update lists, and get list details.
Tasks: Get by ID, search with filters, create, update, delete, and move tasks between lists.
Comments: Get comments for a task and add new comments to a task.
Docs: Retrieve a single page from a ClickUp Doc (v3 API).
Connection Testing: Verify your ClickUp credentials and configuration are working correctly.
Deployment options include stdio mode (for Claude Desktop), HTTP mode for single-tenant or multi-tenant (gateway) deployments, with token-based auth via environment variable or per-request header (X-Clickup-Token).
Provides tools for managing ClickUp workspaces, spaces, folders, lists, tasks, and comments, enabling automated project management operations through the ClickUp API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@clickup-mcplist all spaces in my workspace"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
clickup-mcp
ClickUp MCP server for Claude — exposes ClickUp tasks, spaces, folders, lists, and comments as MCP tools.
Tech stack: Python 3.12 + uv + FastMCP (Starlette/FastAPI)
Quick Start
# Install dependencies
cd D:\leo\mcp-server\clickup-mcp
uv sync
# Run in stdio mode (for Claude Desktop)
$env:CLICKUP_API_TOKEN="pk_xxxxx"
uv run clickup-mcpRelated MCP server: ClickUp MCP
Configuration
Copy .env.example to .env and fill in your values:
Variable | Default | Description |
| — | ClickUp personal API token ( |
|
|
|
|
|
|
|
| HTTP server port |
|
| API base URL |
Get your API token: ClickUp → Settings → Apps → API Token
Claude Desktop Setup
Add to claude_desktop_config.json:
{
"mcpServers": {
"clickup": {
"command": "uv",
"args": ["run", "--directory", "D:/leo/mcp-server/clickup-mcp", "clickup-mcp"],
"env": {
"CLICKUP_API_TOKEN": "pk_xxxxx"
}
}
}
}Transport Modes
stdio (Claude Desktop / CLI)
$env:CLICKUP_API_TOKEN="pk_xxxxx"
uv run clickup-mcpHTTP — single-tenant
$env:CLICKUP_API_TOKEN="pk_xxxxx"
$env:MCP_TRANSPORT="http"
$env:MCP_HTTP_PORT="8080"
uv run clickup-mcpHTTP — gateway / multi-tenant
$env:MCP_TRANSPORT="http"
$env:AUTH_MODE="gateway"
uv run clickup-mcp
# Each request must include: X-Clickup-Token: pk_xxxxxAvailable Tools (23)
Tool | Description |
| List all workspaces/teams |
| List spaces in a workspace |
| Get space details |
| List folders in a space |
| List folderless lists in a space |
| Get folder details |
| List lists in a folder |
| Create a folder |
| Update a folder |
| Delete a folder |
| Get list details |
| Create list in a folder |
| Create list in a space |
| Update a list |
| Get task by ID |
| Search tasks with filters |
| Create a task |
| Update a task |
| Delete a task |
| Move task to a different list |
| Get task comments |
| Add a comment to a task |
| Get a single page from a Doc (v3) |
API Reference
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Related MCP Servers
- Flicense-qualityDmaintenanceProvides integration with ClickUp's API, allowing you to retrieve task information and manage ClickUp data through MCP-compatible clients.Last updated
- Flicense-qualityDmaintenanceEnables ClickUp workspace management including tasks, docs, teams, spaces, and folders through natural language using the ClickUp REST API.Last updated
- Alicense-qualityDmaintenanceEnables interaction with Clickup's project management tools through the MCP protocol, allowing task and project operations via natural language.Last updated1MIT
- Alicense-qualityCmaintenanceEnables AI applications to interact with ClickUp's project management API through the MCP protocol, supporting resources like Teams, Spaces, Goals, and Key Results.Last updated4MIT
Related MCP Connectors
ClickUp MCP — wraps the ClickUp REST API v2 (BYO API key)
Monday.com MCP — wraps the Monday.com GraphQL API (BYO API key)
Manage SRG+ hubs, channels, content, assets, users, and workspaces from any MCP-aware AI agent.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/MSPbotsAI/clickup-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server