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

{
    "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

{
    "clickupApiKey": "pk_XXXXXXXXX",
    "operation": "get_teams"
}

Get Spaces in a Workspace

{
    "clickupApiKey": "pk_XXXXXXXXX",
    "operation": "get_spaces",
    "teamId": "1234567"
}

Create a Task

{
    "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

{
    "clickupApiKey": "pk_XXXXXXXXX",
    "operation": "update_task",
    "taskId": "abc123",
    "status": "in progress",
    "priority": 1
}

Create a Space

{
    "clickupApiKey": "pk_XXXXXXXXX",
    "operation": "create_space",
    "teamId": "1234567",
    "name": "New Project Space"
}

Search Documents

{
    "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:

{
    "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 by Nazruden, licensed under MIT.

Support

• ClickUp API Documentation
• MCP Protocol Specification
• Report Issues

License

MIT License - see LICENSE for details.