ClickUp MCP (Streamable HTTP)

MCP server for ClickUp's REST API with:

• Workspace-wide task search (GET /team/{team_id}/task)

• Task CRUD (+ subtasks)

• Basic browsing (teams, spaces, folders, lists)

• Recent activity helpers (via date_updated_gt, plus audit logs when available)

• Docs CRUD/search (v3 API): search, get, create Docs and Pages

• Escape hatch: generic tool to call any ClickUp API endpoint (v2 and v3).

This server is intended to run as a Docker service and be consumed by OpenWebUI and LibreChat.

Environment

• CLICKUP_API_TOKEN (required)

• CLICKUP_TEAM_ID (optional, will auto-detect first team if unset)

• CLICKUP_WORKSPACE_ID (optional; ClickUp often calls this "team_id" in v2)

• CLICKUP_API_BASE_URL (optional, default https://api.clickup.com/api/v2)

• CLICKUP_API_V3_BASE_URL (optional, default https://api.clickup.com/api/v3)

Run (local)

python -m clickup_mcp --transport streamable-http --host 0.0.0.0 --port 8000 --path /mcp

OpenWebUI should connect to: http://clickup-mcp:8000/mcp

Tools

Tasks (v2 API)

• search_tasks - Search tasks by name/description

• filter_tasks - Filter tasks by metadata (status, assignee, dates, etc.)

• get_task - Get a task by ID

• create_task - Create a new task

• create_subtask - Create a subtask under an existing task

• update_task - Update a task

• delete_task - Delete a task

• get_task_comments - Get comments for a task

• create_task_comment - Create a comment on a task

Browsing (v2 API)

• clickup_context - Get resolved context (team/workspace ID and current user)

• list_teams - List ClickUp teams/workspaces

• get_team - Get a team by ID

• list_spaces - List spaces in a team

• list_folders - List folders in a space

• list_lists_in_space - List (folderless) lists in a space

• list_lists_in_folder - List lists in a folder

• list_tasks_in_list - List tasks in a list

Docs (v3 API)

• search_docs - Search/list all Docs in the workspace

• get_doc - Get a Doc by ID (includes page list)

• create_doc - Create a new Doc

Pages (v3 API)

• list_doc_pages - List all pages in a Doc

• get_doc_page_listing - Get hierarchical page structure for a Doc

• get_doc_page - Get a specific page (with content)

• create_doc_page - Create a new page in a Doc

• update_doc_page - Update/edit a page (replace, append, or prepend content)

Utility

• recent_activity - Get recent activity (audit logs or recently updated tasks)

• clickup_api_request - Generic v2 API escape hatch

• clickup_v3_api_request - Generic v3 API escape hatch

• health - Health check