clickup-mcp-connector

An MCP (Model Context Protocol) server for the ClickUp API. Connects AI assistants like Claude to your ClickUp workspace for managing tasks, docs, time tracking, and more.

Features

• Workspaces & Spaces — List workspaces, create/manage spaces, folders, and lists
• Tasks — Create, update, delete, search tasks with full filter support
• Comments — Read and add comments on tasks
• Time Tracking — Log and retrieve time entries
• Custom Fields — Get, set, and remove custom field values
• Docs — Search, create, and read documents

Installation

npm install -g clickup-mcp-connector

Or run directly with npx:

npx clickup-mcp-connector

Setup

1. Get your ClickUp API token

1. Go to your ClickUp workspace Settings → Apps
2. Generate a Personal API Token
3. Copy the token

2. Configure your MCP client

Add the server to your MCP client configuration (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "clickup-mcp-connector"],
      "env": {
        "CLICKUP_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "clickup": {
      "command": "clickup-mcp-connector",
      "env": {
        "CLICKUP_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | clickup_get_user | Get authenticated user info | | clickup_get_workspaces | List all workspaces/teams | | clickup_get_spaces | Get spaces in a workspace | | clickup_create_space | Create a new space | | clickup_get_folders | Get folders in a space | | clickup_create_folder | Create a new folder | | clickup_get_lists | Get lists in a folder | | clickup_get_folderless_lists | Get lists directly in a space | | clickup_create_list | Create a list in a folder | | clickup_create_folderless_list | Create a list directly in a space | | clickup_get_tasks | Get tasks from a list (paginated) | | clickup_get_task | Get a single task by ID | | clickup_create_task | Create a new task | | clickup_update_task | Update task properties | | clickup_delete_task | Delete a task | | clickup_search_tasks | Search tasks with filters | | clickup_add_tag_to_task | Add a tag to a task | | clickup_remove_tag_from_task | Remove a tag from a task | | clickup_get_comments | Get task comments | | clickup_create_comment | Add a comment to a task | | clickup_get_time_entries | Get time tracking entries | | clickup_create_time_entry | Log a time entry | | clickup_get_custom_fields | Get custom fields for a list | | clickup_set_custom_field_value | Set a custom field value | | clickup_remove_custom_field_value | Remove a custom field value | | clickup_search_docs | Search documents in workspace | | clickup_get_doc_pages | Get pages of a document | | clickup_create_doc | Create a new document |

Development

git clone https://github.com/manojbonala/clickup-mcp-server.git
cd clickup-mcp-connector
npm install
npm run dev

License

MIT