@misddev/clickup-mcp-server

A Model Context Protocol (MCP) server that exposes the ClickUp API as 65 tools for Claude Desktop, Claude Code, and any MCP-compatible AI client.

Features

• 65 tools covering Tasks, Lists, Folders, Spaces, Tags, Time Tracking, Checklists, Documents, Chat
• Bulk operations with partial-failure reporting
• Token-bucket rate limiting (100 req/min by default)
• Automatic retry on 429 and 5xx errors
• Workspace hierarchy with 60s TTL cache
• MIT license — all tools free, no premium gating

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "@misddev/clickup-mcp-server"],
      "env": {
        "CLICKUP_API_KEY": "pk_your_api_key_here",
        "CLICKUP_TEAM_ID": "your_workspace_id"
      }
    }
  }
}

Claude Code

claude mcp add clickup -- npx -y @misddev/clickup-mcp-server

Then set environment variables in your shell or .env:

CLICKUP_API_KEY=pk_your_api_key_here
CLICKUP_TEAM_ID=your_workspace_id

Getting Your Credentials

1. API Key: ClickUp Settings → Apps → API Token → Generate or copy your Personal API Token
2. Team/Workspace ID: Open ClickUp in browser → the number in the URL after app.clickup.com/ is your Workspace ID

Configuration

| Variable | Required | Default | Description | |---|---|---|---| | CLICKUP_API_KEY | ✅ | — | Personal API token from ClickUp settings | | CLICKUP_TEAM_ID | ✅ | — | Workspace ID (numeric, from ClickUp URL) | | CLICKUP_LOG_LEVEL | — | info | debug / info / warn / error | | CLICKUP_DISABLED_TOOLS | — | — | Comma-separated domains to disable, e.g. chat,docs | | CLICKUP_RATE_LIMIT_RPM | — | 100 | Requests per minute (increase if on Enterprise plan) |

Tools

Tasks (15)

create_task · get_task · update_task · delete_task · duplicate_task · move_task · get_task_comments · create_task_comment · add_tag_to_task · remove_tag_from_task · add_task_link · delete_task_link · get_task_links · attach_task_file · set_task_custom_field

Bulk Tasks (4)

create_bulk_tasks · update_bulk_tasks · delete_bulk_tasks · move_bulk_tasks

Lists (9)

create_list · create_list_in_folder · get_list · update_list · delete_list · move_list · get_list_custom_fields · add_task_to_list · remove_task_from_list

Folders (5)

create_folder · get_folder · update_folder · delete_folder · move_folder

Spaces & Workspace (4)

get_workspace_hierarchy · get_workspace_tasks · get_workspace_members · find_member_by_name

Tags (4)

get_space_tags · create_space_tag · update_space_tag · delete_space_tag

Time Tracking (7)

start_time_tracking · stop_time_tracking · get_current_time_entry · add_time_entry · delete_time_entry · get_task_time_entries · get_workspace_time_entries

Checklists (6)

create_checklist · edit_checklist · delete_checklist · create_checklist_item · edit_checklist_item · delete_checklist_item

Documents (7)

list_documents · get_document · create_document · list_document_pages · get_document_pages · create_document_page · update_document_page

Chat (4)

get_chat_channels · create_chat_channel · get_chat_messages · create_chat_message

Development

git clone https://github.com/misddev1412/clickup-mcp-server
cd clickup-mcp-server
npm install
npm test          # Run tests (vitest + MSW)
npm run build     # Build to dist/
npm run typecheck # TypeScript type check

Example Prompts

• "Show me all tasks assigned to me in the Marketing space"
• "Create 5 tasks in the Q2 Planning list: kickoff meeting, stakeholder review, budget sign-off, team sync, launch"
• "Move all 'In Review' tasks from Sprint 12 to the Done list"
• "Log 2 hours on task #abc123 for today"
• "Create a checklist called 'Launch Checklist' on the product launch task"
• "What's in the Engineering workspace hierarchy?"

License

MIT