Clickup Automation

# ClickUp Automation via Rube MCP

Automate ClickUp project management workflows including task creation and updates, workspace hierarchy navigation, comments, and team member management through Composio's ClickUp toolkit.

Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)

- Active ClickUp connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `clickup`

- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds

2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `clickup`

3. If connection is not ACTIVE, follow the returned auth link to complete ClickUp OAuth

4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Create and Manage Tasks

**When to use**: User wants to create tasks, subtasks, update task properties, or list tasks in a ClickUp list.

**Tool sequence**:

1. `CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES` - Get workspace/team IDs [Prerequisite]

2. `CLICKUP_GET_SPACES` - List spaces in the workspace [Prerequisite]

3. `CLICKUP_GET_FOLDERS` - List folders in a space [Prerequisite]

4. `CLICKUP_GET_FOLDERLESS_LISTS` - Get lists not inside folders [Optional]

5. `CLICKUP_GET_LIST` - Validate list and check available statuses [Prerequisite]

6. `CLICKUP_CREATE_TASK` - Create a task in the target list [Required]

7. `CLICKUP_CREATE_TASK` (with `parent`) - Create subtask under a parent task [Optional]

8. `CLICKUP_UPDATE_TASK` - Modify task status, assignees, dates, priority [Optional]

9. `CLICKUP_GET_TASK` - Retrieve full task details [Optional]

10. `CLICKUP_GET_TASKS` - List all tasks in a list with filters [Optional]

11. `CLICKUP_DELETE_TASK` - Permanently remove a task [Optional]

**Key parameters for CLICKUP_CREATE_TASK**:

- `list_id`: Target list ID (integer, required)

- `name`: Task name (string, required)

- `description`: Detailed task description

- `status`: Must exactly match (case-sensitive) a status name configured in the target list

- `priority`: 1 (Urgent), 2 (High), 3 (Normal), 4 (Low)

- `assignees`: Array of user IDs (integers)

- `due_date`: Unix timestamp in milliseconds

- `parent`: Parent task ID string for creating subtasks

- `tags`: Array of tag name strings

- `time_estimate`: Estimated time in milliseconds

**Pitfalls**:

- `status` is case-sensitive and must match an existing status in the list; use `CLICKUP_GET_LIST` to check available statuses

- `due_date` and `start_date` are Unix timestamps in **milliseconds**, not seconds

- Subtask `parent` must be a task (not another subtask) in the same list

- `notify_all` triggers watcher notifications; set to false for bulk operations

- Retries can create duplicates; track created task IDs to avoid re-creation

- `custom_item_id` for milestones (ID 1) is subject to workspace plan quotas

2. Navigate Workspace Hierarchy

**When to use**: User wants to browse or manage the ClickUp workspace structure (Workspaces > Spaces > Folders > Lists).

**Tool sequence**:

1. `CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES` - List all accessible workspaces [Required]

2. `CLICKUP_GET_SPACES` - List spaces within a workspace [Required]

3. `CLICKUP_GET_SPACE` - Get details for a specific space [Optional]

4. `CLICKUP_GET_FOLDERS` - List folders in a space [Required]

5. `CLICKUP_GET_FOLDER` - Get details for a specific folder [Optional]

6. `CLICKUP_CREATE_FOLDER` - Create a new folder in a space [Optional]

7. `CLICKUP_GET_FOLDERLESS_LISTS` - List lists not inside any folder [Required]

8. `CLICKUP_GET_LIST` - Get list details including statuses and custom fields [Optional]

**Key parameters**:

- `team_id`: Workspace ID from GET_AUTHORIZED_TEAMS_WORKSPACES (required for spaces)

- `space_id`: Space ID (required for folders and folderless lists)

- `folder_id`: Folder ID (required for GET_FOLDER)