Clickup Mcp Server

{"skills": {"allowBundled": ["mcporter"]}}

# Add ClickUp as a remote server
mcporter config add ClickUp https://clickup-mcp.taazkareem.com/mcp --auth oauth --header "X-License-Key=your-license-key"

# Authenticate session
mcporter auth ClickUp

# Define an Auditor persona (Read-only) in your workspace config
mcporter --config 

  Cursor

**Configuration Path:** `/.cursor/mcp.json`

**Option A: Remote / Streamable HTTP (Easiest)**

**Option B: Local / STDIO**

  VS Code  

**Configuration Paths:**
- **Global:** `~/Library/Application Support/Code/User/mcp.json`
- **Local:** `/.vscode/mcp.json`

**Option A: Remote / Streamable HTTP (Easiest)**

**Option B: Local / STDIO**

  Roo Code  

**Configuration Path:** `/.roo/mcp.json`

**Option A: Remote / Streamable HTTP (Easiest)**

**Option B: Local / STDIO**

  Claude Desktop  

**Configuration Path:** `~/Library/Application Support/Claude/claude_desktop_config.json`

**Remote Setup (Requires `mcp-remote` adapter):**

  Claude Code (CLI)  

Run this command in your terminal:

  n8n  

**Option A: Remote / Streamable HTTP (Recommended)**
1. In n8n, add an **"MCP Client"** node.
2. Set Connection Type to `Streamable HTTP`.
3. Auth Type: `Multiple Headers Auth`.
4. Header: `X-License-Key` Value: `your-license-key`
5. URL: `https://clickup-mcp.taazkareem.com/mcp`

**Option B: Self-Hosted Docker**
Run the container:

In n8n, use URL: `http://host.docker.internal:3231/mcp`

  Gemini CLI  

**Configuration Path:** `~/.gemini/settings.json`

  Antigravity  

**Configuration Path:** `~/.gemini/antigravity/mcp_config.json`

  Codex (CLI, Desktop, IDE)  

Codex clients (CLI, Desktop App, and VS Code extension) share a single source of truth for configuration.

**Configuration Paths:**
- **Global:** `~/.codex/config.toml`
- **Local:** `/.codex/config.toml`

**Option A: Remote / Streamable HTTP (Easiest)**

**Option B: Local / STDIO**

**Quick Tips:**
- **Codex CLI:** Run `codex mcp list` to verify. Use `codex mcp add ...` as a CLI alternative to editing the file.
- **VS Code Extension:** Click **⚙ → MCP settings → Open config.toml**.
- **Desktop App:** Go to **Settings → Integrations & MCP**.

  ChatGPT (Developer Mode)  

*Note: Requires a Business, Enterprise, or Edu workspace with Developer Mode enabled.*

1. **Enable Developer Mode:** Ask your workspace admin to enable this under **Workspace Settings → Permissions & Roles → Connected Data**.
2. **Connect MCP:** Go to **Settings → Connectors** and toggle **Developer Mode** on.
3. **Add Custom Connector:**
   - Click **Add connector** (or "Create custom connector").
   - Choose **MCP** as the source type.
4. **Configure:**
   - **Server URL:** `https://clickup-mcp.taazkareem.com/mcp`
   - **Authentication:** Add HTTP header `X-License-Key: your-license-key`.
5. **Use:** Start a Developer Mode chat and select your ClickUp connector via **Add sources**.

  Augment Code  

**Configuration Path:** `/.augment/settings.json`

  Auggie CLI  

Run this command in your terminal:

  Windsurf

**Configuration Path:** `/.codeium/windsurf/mcp_config.json`

**Option A: Remote / Streamable HTTP (Easiest)**

**Option B: Local / STDIO**

 Other (Custom Agents, etc.)  

For most MCP-compliant hosts (e.g. Smithery, MCP Inspector, custom GUIs):
*   **Server URL:** `https://clickup-mcp.taazkareem.com/mcp`
*   **Auth Header:** `X-License-Key: your-license-key` (Required for HTTP/SSE connections)

---

**Advanced: OpenAI Agents SDK**
For developers building custom agents.

**Python SDK:**

### 3. Restart
Restart your MCP Host (e.g., Cursor IDE). The server will validate your License Key and start automatically.

---

## 🛠️ Available Tools

👇 Click to view all 150 available tools

| Category | Tool | Description |
| :--- | :--- | :--- |
| **Workspace** | `get_workspace` | Get workspace structure and metadata (hierarchy, members, plan, seats, shared items, custom task types) |
| | `get_workspace_seats` | Get member and guest seat utilization (used, total, available) |
| | `get_workspace_plan` | Get plan details for the workspace (plan_name, plan_id) |
| | `get_audit_logs` | Retrieve workspace audit logs (Enterprise only) |
| **Tasks** | `create_task` | Create a task |
| | `get_task` | Get single task details |
| | `update_task` | Modify task properties |
| | `move_task` | Move task to new list |
| | `duplicate_task` | Copy task |
| | `delete_task` | Remove task |
| | `add_task_to_list` | Associate task with additional list (TIML) |
| | `remove_task_from_list` | Remove task list association (TIML) |
| | `create_bulk_tasks` | Create multiple tasks |
| | `update_bulk_tasks` | Update multiple tasks |
| | `move_bulk_tasks` | Move multiple tasks |
| | `delete_bulk_tasks` | Delete multiple tasks |
| | `get_workspace_tasks` | Search tasks with Deep Search filtering |
| | `get_comments` | Get comments on a task, list, or view |
| | `create_comment` | Create a comment on a task, list, or view |
| | `update_comment` | Edit or resolve a comment |
| | `delete_comment` | Delete a comment |
| | `get_comment_replies` | Get threaded replies for a comment |
| | `create_comment_reply` | Reply to a comment in a thread |
| | `add_comment_reaction` | Add an emoji reaction to a comment |
| | `remove_comment_reaction` | Remove an emoji reaction from a comment |
| | `get_comment_subtypes` | Get post subtype IDs for the workspace |
| | `add_task_link` | Link two tasks together |
| | `get_task_links` | Get task links |
| | `delete_task_link` | Remove a task link |
| | `add_task_dependency` | Set a blocking dependency between tasks |
| | `delete_task_dependency` | Remove a blocking dependency between tasks |
| **Attachments** | `list_attachments` | List attachments for a task or file custom field (v3) |
| | `get_attachment` | Get a specific attachment by ID or name (v3) |
| | `upload_attachment` | Upload a file to a task or file custom field (v3) |
| **Checklists** | `create_checklist` | Add a checklist to a task |
| | `edit_checklist` | Rename or reorder a checklist |
| | `delete_checklist` | Delete a checklist and all its items |
| | `create_checklist_item` | Add an item to a checklist |
| | `edit_checklist_item` | Update a checklist item (name, resolved, assignee, nesting) |
| | `delete_checklist_item` | Remove an item from a checklist |
| **Sprints** | `get_active_sprint` | Auto-detect the currently active sprint; returns tasks if exactly one found |
| | `list_sprints` | List all sprints in a folder |
| | `get_sprint_tasks` | Get tasks for a specific sprint list |
| **Lists** | `list_lists` | Retrieve lists in a space (folderless) or in a folder |
| | `get_list` | Get list details |
| | `create_list` | Create a list in a space or folder |
| | `create_list_from_template` | Create a new list from a template |
| | `update_list` | Update list properties |
| | `delete_list` | Delete a list |
| | `move_list` | Move a list to a different space or folder (high-integrity) |
| | `set_list_permissions` | Update list privacy and sharing (ACLs) |
| **Custom Fields** | `list_custom_fields` | List field definitions for a list, folder, or space |
| | `create_custom_field` | Add a new field definition to a list |
| | `set_custom_field_value` | Set a field value on a task |
| | `remove_custom_field_value` | Clear a field value from a task |
| **Spaces** | `list_spaces` | List all spaces in the workspace |
| | `get_space` | Get space details |
| | `create_space` | Create a new space |
| | `update_space` | Update space properties |
| | `delete_space` | Delete a space |
| | `set_space_permissions` | Update space privacy and sharing (ACLs) |
| **Goals** | `list_goals` | List all goals in the workspace |
| | `get_goal` | Get a goal with its key results |
| | `create_goal` | Create a new goal |
| | `update_goal` | Update a goal's properties |
| | `delete_goal` | Delete a goal |
| | `create_key_result` | Add a key result to a goal |
| | `update_key_result` | Update a key result |
| | `delete_key_result` | Delete a key result |
| **Views** | `list_views` | List views for a space, folder, list, or workspace |
| | `get_view` | Get a single view |
| | `create_view` | Create a new view |
| | `update_view` | Update a view |
| | `delete_view` | Delete a view |
| | `get_view_tasks` | Get tasks in a view |
| **Folders** | `list_folders` | List all folders in a space |
| | `get_folder` | Get folder details and its contained lists |
| | `create_folder` | Create a folder in a space |
| | `update_folder` | Update folder properties |
| | `delete_folder` | Delete a folder |
| | `move_folder` | Move a folder to a different space (high-integrity) |
| | `set_folder_permissions` | Update folder privacy and sharing (ACLs) |
| | `create_folder_from_template` | Create a folder from a template in a space |
| **Tags** | `list_space_tags` | List all tags in a space |
| | `create_space_tag` | Create a new space tag |
| | `update_space_tag` | Update a space tag's name or colors |
| | `delete_space_tag` | Delete a tag from a space |
| | `add_tag_to_task` | Add tag to task |
| | `remove_tag_from_task` | Remove tag from task |
| **Time Tracking** | `get_time_entries` | Fetch historical time entries |
| | `get_current_time_entry` | Get currently running timer |
| | `start_time_entry` | Start tracking time for a task |
| | `stop_time_entry` | Stop the active timer |
| | `add_time_entry` | Manually log a time entry |
| | `update_time_entry` | Modify an existing time entry |
| | `delete_time_entry` | Delete a time entry |
| | `get_time_entry_tags` | Fetch all workspace time entry tags |
| | `add_time_entry_tags` | Add a tag to a time entry |
| | `update_time_entry_tags` | Rename a workspace time entry tag globally |
| | `delete_time_entry_tags` | Remove a tag from a time entry |
| | `get_time_entry_history` | View edit history of a time entry |
| | `get_time_in_status` | Get time-in-status for multiple tasks |
| **Docs** | `list_documents` | List documents in a workspace or container |
| | `get_document` | Get document metadata |
| | `create_document` | Create a new standalone document |
| | `list_document_pages` | List all pages in a document |
| | `get_document_page` | Get content for a single page |
| | `get_document_pages` | Get content for multiple pages in one call |
| | `create_document_page` | Add a new page to a document |
| | `update_document_page` | Modify an existing page (replace/append/prepend) |
| **Chat** | `list_chat_channels` | List all channels in the workspace |
| | `get_chat_channel` | Get a single channel |
| | `create_chat_channel` | Create a new channel |
| | `update_chat_channel` | Update a channel |
| | `delete_chat_channel` | Delete a channel |
| | `get_chat_channel_members` | Get members of a channel |
| | `get_chat_channel_followers` | Get followers of a channel |
| | `create_chat_dm` | Create a direct message channel |
| | `get_chat_messages` | Get messages from a channel |
| | `create_chat_message` | Send a message to a channel |
| | `update_chat_message` | Edit a message |
| | `delete_chat_message` | Delete a message |
| | `get_chat_message_replies` | Get threaded replies to a message |
| | `create_chat_message_reply` | Reply to a message in a thread |
| | `add_chat_reaction` | Add an emoji reaction to a message |
| | `remove_chat_reaction` | Remove an emoji reaction |
| | `get_chat_reactions` | Get all reactions on a message |
| | `get_chat_tagged_users` | Get users tagged in a message |
| | `get_chat_message_subtypes` | Get post subtype IDs for the workspace |
| **Webhooks** | `list_webhooks` | List all webhooks in the workspace |
| | `create_webhook` | Create a new webhook |
| | `update_webhook` | Update an existing webhook |
| | `delete_webhook` | Delete a webhook permanently |
| **User Groups** | `list_user_groups` | List all user groups in the workspace |
| | `create_user_group` | Create a new user group |
| | `update_user_group` | Rename a group or add/remove members |
| | `delete_user_group` | Delete a user group |
| **Guests** | `invite_guest` | Invite a guest to the workspace (Enterprise) |
| | `get_guest` | Get guest details (Enterprise) |
| | `edit_guest` | Edit guest display name or permissions (Enterprise) |
| | `remove_guest` | Remove a guest from the workspace (Enterprise) |
| | `add_guest_to_task` | Grant guest access to a task (Enterprise) |
| | `remove_guest_from_task` | Revoke guest access from a task (Enterprise) |
| | `add_guest_to_list` | Grant guest access to a list (Enterprise) |
| | `remove_guest_from_list` | Revoke guest access from a list (Enterprise) |
| | `add_guest_to_folder` | Grant guest access to a folder (Enterprise) |
| | `remove_guest_from_folder` | Revoke guest access from a folder (Enterprise) |
| **Task Templates** | `get_task_templates` | List available workspace templates |
| | `create_task_from_template` | Create a task from a template |
| **Feedback** | `submit_feedback` | Submit feedback or bug reports |

*See [full documentation](docs/DOCUMENTATION.md) for parameters and advanced usage.*

---

## ⚙️ Advanced Configuration

### Filter Available Tools
💡 **Pro Tip!** Reduce context noise for the AI by limiting available tools.

**Local (Environment Variable):**

-or- **Remote (Header):**

### Preset Configurations

Simplify setup by using **Personas**. You can set a persona via the `CLICKUP_MCP_PERSONA` environment variable or the `X-Persona` HTTP header to automatically filter a set of tools. 

Multiple personas can be combined (e.g., `"X-Persona": "task_worker,time_specialist"`).

  
    
      Persona
      Description
      Target Use Case
    
  
  
    
      📋 auditor
      Read-only access
      View tasks, goals, docs, and chat (Read-only).
    
    
      👷 task_worker
      Daily management
      Task CRUD, time tracking, and checklists.
    
    
      ⏱️ time_specialist
      Time tracking focus
      Time logs, timesheets, and entry history.
    
    
      🏗️ project_manager
      High-level control
      Spaces, folders, lists, and bulk operations.
    
    
      📚 content_manager
      Communication
      Docs, chat, comments, and attachments.
    
    
      🏢 workspace_admin
      Admin control
      Permissions, guests, and audit logs.
    
    
      💻 developer
      Programmatic
      Webhooks, custom fields, bulk automation.
    
    
      🌟 most_popular
      Common tools
      Most frequently called endpoints.
    
    
      🛡️ safe_power_user
      Full access
      All tools except destructive deletes/removals.
    
  

**Local (Environment Variable):**

-or- **Remote (Header):**

> **💡 Need to customize?** To view the exact tools included in each preset or to build a custom list based on a persona, see the [Personas Reference Guide](./docs/reference/personas.md).
---

### 🌍 Multi-Workspace Support

Simultaneously federate OAuth and multiple API keys to manage tasks across different authorized ClickUp accounts/workspaces in a single session. Easily move or duplicate tasks between workspaces, configure AI Agents for cross-workspace automation, and more.

**Remote (Headers):**

---

## ❓ FAQ

**Why isn't this free anymore?**
Building reliable MCP integrations requires significant maintenance. Moving to a paid model allows us to support this as a product rather than a hobby, ensuring compatibility with API changes.

**I have an old version. Will it stop working?**
Existing local clones will continue to work, but you will not receive updates, bug fixes, or support without a license.

**How do I get support?**
Premium users get priority support. Please [open an issue](https://github.com/TaazKareem/clickup-mcp-server/issues) in this repository.

---

## ⚖️ Disclaimer

Originally developed as open source and refined during a consultancy with ClickUp, this project is now independently maintained.

This software makes use of third-party APIs and may reference trademarks or brands owned by third parties. The use of such APIs or references does not imply any affiliation with or endorsement by the respective companies. All trademarks and brand names are the property of their respective owners. This project is an independent work and is not officially associated with or sponsored by any third-party company mentioned.