# ClickUp MCP Server (`regdata/clickup-mcp-server`) Actor Connect AI assistants to ClickUp via MCP. 20 tools for tasks, spaces, folders, lists, views, docs. Works with Claude, ChatGPT, n8n workflows - **URL**: https://apify.com/regdata/clickup-mcp-server.md - **Developed by:** [regdata](https://apify.com/regdata) (community) - **Categories:** MCP servers, AI, Automation - **Stats:** 2 total users, 1 monthly users, 82.9% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ClickUp MCP Server Connect AI assistants to your ClickUp workspace using the Model Context Protocol (MCP). This actor enables Claude, ChatGPT, and other AI tools to manage tasks, spaces, folders, lists, views, and docs through 20 powerful operations. ### Why Use This Actor? - **AI-Ready**: Works with Claude Desktop, ChatGPT, and any MCP-compatible AI - **Complete Task Management**: Create, update, delete, and organize tasks - **Workspace Control**: Manage spaces, folders, lists, and views - **Document Support**: Search and create ClickUp Docs - **Custom Fields**: Read and set custom field values - **No Code Required**: Just provide your ClickUp API token ### Available Operations (20 Tools) #### Workspace & Organization | Tool | Description | |------|-------------| | `get_teams` | List all workspaces you have access to | | `get_spaces` | Get spaces within a workspace | | `create_space` | Create a new space with features enabled | | `get_folders` | List folders in a space | | `create_folder` | Create a new folder | | `get_lists` | Get lists from folder or space | | `create_list` | Create a new list | #### Task Management | Tool | Description | |------|-------------| | `get_tasks` | Get all tasks from a list | | `get_task` | Get a single task by ID | | `create_task` | Create a new task with full options | | `update_task` | Update task properties | | `delete_task` | Delete a task | #### Views | Tool | Description | |------|-------------| | `get_views` | List views for team/space/folder/list | | `create_view` | Create list, board, calendar, or gantt view | | `get_view_tasks` | Get tasks from a specific view | #### Custom Fields | Tool | Description | |------|-------------| | `get_custom_fields` | List custom fields for a list | | `set_custom_field` | Set custom field value on a task | #### Documents | Tool | Description | |------|-------------| | `search_docs` | Search workspace documentation | | `create_doc` | Create a new document | | `get_doc_pages` | List pages in a document | ### Quick Start #### 1. Get Your ClickUp API Token 1. Open ClickUp 2. Go to **Settings** (bottom left) 3. Click **Apps** 4. Find **API Token** and click **Generate** 5. Copy your personal API token #### 2. Run in Batch Mode ```json { "clickupApiKey": "pk_XXXXXXXXX", "mode": "batch", "operation": "get_teams" } ```` #### 3. Get Your Team ID Run `get_teams` first to find your Workspace/Team ID, then use it for other operations. ### Usage Examples #### List All Workspaces ```json { "clickupApiKey": "pk_XXXXXXXXX", "operation": "get_teams" } ``` #### Get Spaces in a Workspace ```json { "clickupApiKey": "pk_XXXXXXXXX", "operation": "get_spaces", "teamId": "1234567" } ``` #### Create a Task ```json { "clickupApiKey": "pk_XXXXXXXXX", "operation": "create_task", "listId": "12345678", "name": "New feature implementation", "description": "Implement the new dashboard feature", "status": "to do", "priority": 2, "dueDate": "2026-01-15", "tags": ["feature", "frontend"] } ``` #### Update a Task ```json { "clickupApiKey": "pk_XXXXXXXXX", "operation": "update_task", "taskId": "abc123", "status": "in progress", "priority": 1 } ``` #### Create a Space ```json { "clickupApiKey": "pk_XXXXXXXXX", "operation": "create_space", "teamId": "1234567", "name": "New Project Space" } ``` #### Search Documents ```json { "clickupApiKey": "pk_XXXXXXXXX", "operation": "search_docs", "teamId": "1234567", "searchQuery": "API documentation" } ``` ### Input Reference | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `clickupApiKey` | string | Yes | Your ClickUp Personal API Token | | `mode` | string | No | `batch` (default) or `standby` | | `operation` | string | No | Operation to perform | | `teamId` | string | No | Workspace/Team ID | | `spaceId` | string | No | Space ID | | `folderId` | string | No | Folder ID | | `listId` | string | No | List ID | | `taskId` | string | No | Task ID | | `viewId` | string | No | View ID | | `docId` | string | No | Document ID | | `name` | string | No | Name for new items | | `description` | string | No | Description text | | `status` | string | No | Task status | | `priority` | integer | No | Priority (1-4) | | `assignees` | array | No | User IDs to assign | | `dueDate` | string | No | Due date (ISO or timestamp) | | `tags` | array | No | Tag names | | `customFieldId` | string | No | Custom field ID | | `customFieldValue` | string | No | Value for custom field | | `searchQuery` | string | No | Search query for docs | | `viewType` | string | No | View type (list/board/calendar/gantt) | ### Output Results are stored in the dataset: ```json { "operation": "create_task", "id": "abc123xyz", "name": "New feature implementation", "status": { "status": "to do", "color": "#d3d3d3" }, "priority": { "priority": "high", "color": "#ffcc00" } } ``` ### Use Cases - **AI Task Creation**: Let Claude create and organize tasks from conversations - **Automated Reporting**: Generate task reports and summaries - **Workflow Automation**: Integrate with n8n, Make, or Zapier - **Project Setup**: Quickly create spaces, folders, and lists - **Status Updates**: Update task statuses via natural language ### Pricing This actor uses Apify platform resources: - **Batch operations**: ~$0.001 per run - **Standby mode**: Billed per compute unit while active ### Attribution Based on [clickup-mcp-server](https://github.com/Nazruden/clickup-mcp-server) by Nazruden, licensed under MIT. ### Support - [ClickUp API Documentation](https://clickup.com/api) - [MCP Protocol Specification](https://modelcontextprotocol.io/) - [Report Issues](https://github.com/nolpak14/clickup-mcp-actor/issues) ### License MIT License - see [LICENSE](LICENSE) for details. # Actor input Schema ## `clickupApiKey` (type: `string`): Your ClickUp Personal API Token. Get it from ClickUp Settings > Apps > API Token ## `mode` (type: `string`): How to run the MCP server. Standby mode runs as a persistent MCP HTTP server. Batch mode executes a single operation. ## `operation` (type: `string`): Operation to perform in batch mode. ## `teamId` (type: `string`): ClickUp Team (Workspace) ID. Required for most operations. ## `spaceId` (type: `string`): Space ID for folder/list operations. ## `folderId` (type: `string`): Folder ID for list operations. ## `listId` (type: `string`): List ID for task operations. ## `taskId` (type: `string`): Task ID for single task operations (get, update, delete). ## `viewId` (type: `string`): View ID for view operations. ## `docId` (type: `string`): Document ID for doc operations. ## `name` (type: `string`): Name for creating spaces, folders, lists, tasks, or docs. ## `description` (type: `string`): Description for tasks or docs. ## `status` (type: `string`): Task status (e.g., 'to do', 'in progress', 'complete'). ## `priority` (type: `integer`): Task priority: 1 (urgent), 2 (high), 3 (normal), 4 (low). ## `assignees` (type: `array`): Array of user IDs to assign to the task. ## `dueDate` (type: `string`): Due date in ISO format or Unix timestamp (milliseconds). ## `tags` (type: `array`): Array of tag names for the task. ## `customFieldId` (type: `string`): Custom field ID for set\_custom\_field operation. ## `customFieldValue` (type: `string`): Value to set for the custom field. ## `searchQuery` (type: `string`): Search query for search\_docs operation. ## `viewType` (type: `string`): Type of view to create. ## `maxResults` (type: `integer`): Maximum number of results to return. ## Actor input object example ```json { "mode": "batch", "operation": "get_teams", "priority": 3, "maxResults": 100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("regdata/clickup-mcp-server").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("regdata/clickup-mcp-server").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call regdata/clickup-mcp-server --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=regdata/clickup-mcp-server", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ClickUp MCP Server", "description": "Connect AI assistants to ClickUp via MCP. 20 tools for tasks, spaces, folders, lists, views, docs. Works with Claude, ChatGPT, n8n workflows", "version": "1.0", "x-build-id": "If1lodQI6VBPCGffX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/regdata~clickup-mcp-server/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-regdata-clickup-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/regdata~clickup-mcp-server/runs": { "post": { "operationId": "runs-sync-regdata-clickup-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/regdata~clickup-mcp-server/run-sync": { "post": { "operationId": "run-sync-regdata-clickup-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "clickupApiKey" ], "properties": { "clickupApiKey": { "title": "ClickUp Personal API Token", "type": "string", "description": "Your ClickUp Personal API Token. Get it from ClickUp Settings > Apps > API Token" }, "mode": { "title": "Mode", "enum": [ "standby", "batch" ], "type": "string", "description": "How to run the MCP server. Standby mode runs as a persistent MCP HTTP server. Batch mode executes a single operation.", "default": "batch" }, "operation": { "title": "Operation", "enum": [ "get_teams", "get_spaces", "create_space", "get_folders", "create_folder", "get_lists", "create_list", "get_tasks", "get_task", "create_task", "update_task", "delete_task", "get_views", "create_view", "get_view_tasks", "get_custom_fields", "set_custom_field", "search_docs", "create_doc", "get_doc_pages" ], "type": "string", "description": "Operation to perform in batch mode.", "default": "get_teams" }, "teamId": { "title": "Team/Workspace ID", "type": "string", "description": "ClickUp Team (Workspace) ID. Required for most operations." }, "spaceId": { "title": "Space ID", "type": "string", "description": "Space ID for folder/list operations." }, "folderId": { "title": "Folder ID", "type": "string", "description": "Folder ID for list operations." }, "listId": { "title": "List ID", "type": "string", "description": "List ID for task operations." }, "taskId": { "title": "Task ID", "type": "string", "description": "Task ID for single task operations (get, update, delete)." }, "viewId": { "title": "View ID", "type": "string", "description": "View ID for view operations." }, "docId": { "title": "Doc ID", "type": "string", "description": "Document ID for doc operations." }, "name": { "title": "Name", "type": "string", "description": "Name for creating spaces, folders, lists, tasks, or docs." }, "description": { "title": "Description", "type": "string", "description": "Description for tasks or docs." }, "status": { "title": "Status", "type": "string", "description": "Task status (e.g., 'to do', 'in progress', 'complete')." }, "priority": { "title": "Priority", "minimum": 1, "maximum": 4, "type": "integer", "description": "Task priority: 1 (urgent), 2 (high), 3 (normal), 4 (low).", "default": 3 }, "assignees": { "title": "Assignees", "type": "array", "description": "Array of user IDs to assign to the task.", "items": { "type": "string" } }, "dueDate": { "title": "Due Date", "type": "string", "description": "Due date in ISO format or Unix timestamp (milliseconds)." }, "tags": { "title": "Tags", "type": "array", "description": "Array of tag names for the task.", "items": { "type": "string" } }, "customFieldId": { "title": "Custom Field ID", "type": "string", "description": "Custom field ID for set_custom_field operation." }, "customFieldValue": { "title": "Custom Field Value", "type": "string", "description": "Value to set for the custom field." }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Search query for search_docs operation." }, "viewType": { "title": "View Type", "enum": [ "list", "board", "calendar", "gantt" ], "type": "string", "description": "Type of view to create." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of results to return.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```