> ## Documentation Index
> Fetch the complete documentation index at: https://docs.civic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp

> Manage tasks, track time, and collaborate on projects with ClickUp's comprehensive project management tools

## Overview

The ClickUp server enables AI assistants to interact with [ClickUp](https://clickup.com) workspaces, providing powerful task management, sprint planning, and team collaboration capabilities through conversational AI.

## How to Add ClickUp

<Steps>
  <Step title="Create ClickUp Account">
    1. Go to [http://ClickUp.com](http://ClickUp.com)
    2. Sign up for a free account or use your existing workspace
  </Step>

  <Step title="Generate API Token">
    1. In ClickUp, click your profile avatar
    2. Go to **Settings > Apps**
    3. Generate a new API token
    4. Copy the token for use in Civic
  </Step>

  <Step title="Connect to Civic">
    1. Add the ClickUp server to your Civic environment
    2. Enter your API token when prompted
  </Step>

  <Step title="Test Connection">
    Start with a simple command like "Show me all tasks assigned to me" to verify the connection works properly.
  </Step>
</Steps>

<Tip>
  ClickUp's MCP server is actively evolving. Features may change in the coming weeks as the platform stabilizes.
</Tip>

## What You Can Do

<CardGroup cols={2}>
  <Card title="Task Management" icon="list-check">
    Create, update, and track tasks with full field management and status updates
  </Card>

  <Card title="Sprint Planning" icon="calendar-days">
    Organize sprints, create task lists, and manage project timelines
  </Card>

  <Card title="Team Collaboration" icon="users">
    Assign tasks, add comments, and coordinate team activities
  </Card>

  <Card title="Documentation" icon="file-lines">
    Create documents and organize project knowledge within ClickUp
  </Card>
</CardGroup>

## Available Tools (41)

### Search & Hierarchy

<AccordionGroup>
  <Accordion title="clickup_search">
    Search across your ClickUp workspace for tasks, documents, and content
  </Accordion>

  <Accordion title="clickup_get_workspace_hierarchy">
    Get the complete workspace structure including spaces, folders, and lists
  </Accordion>
</AccordionGroup>

### Task Management

<AccordionGroup>
  <Accordion title="clickup_create_task">
    Create new tasks with priorities, assignees, due dates, and tags
  </Accordion>

  <Accordion title="clickup_get_task">
    Retrieve detailed information about a specific task
  </Accordion>

  <Accordion title="clickup_update_task">
    Update task details, status, priority, or assignments
  </Accordion>

  <Accordion title="clickup_create_bulk_tasks">
    Create multiple tasks in a single operation
  </Accordion>

  <Accordion title="clickup_update_bulk_tasks">
    Update multiple tasks in a single operation
  </Accordion>

  <Accordion title="clickup_get_workspace_tasks">
    Retrieve tasks from across the workspace with filtering options
  </Accordion>
</AccordionGroup>

### Comments & Files

<AccordionGroup>
  <Accordion title="clickup_get_task_comments">
    Retrieve comments from a task
  </Accordion>

  <Accordion title="clickup_create_task_comment">
    Add comments to tasks for team communication
  </Accordion>

  <Accordion title="clickup_attach_task_file">
    Attach files to tasks
  </Accordion>
</AccordionGroup>

### Time Tracking

<AccordionGroup>
  <Accordion title="clickup_get_task_time_entries">
    Get time tracking entries for a task
  </Accordion>

  <Accordion title="clickup_start_time_tracking">
    Start tracking time on a task
  </Accordion>

  <Accordion title="clickup_stop_time_tracking">
    Stop the current time tracking session
  </Accordion>

  <Accordion title="clickup_add_time_entry">
    Add a time entry to a task
  </Accordion>

  <Accordion title="clickup_get_current_time_entry">
    Get the currently running time entry
  </Accordion>
</AccordionGroup>

### List Management

<AccordionGroup>
  <Accordion title="clickup_create_list">
    Create task lists within spaces
  </Accordion>

  <Accordion title="clickup_create_list_in_folder">
    Create task lists within folders
  </Accordion>

  <Accordion title="clickup_get_list">
    Get details about a specific list
  </Accordion>

  <Accordion title="clickup_update_list">
    Update list settings and properties
  </Accordion>
</AccordionGroup>

### Folder Management

<AccordionGroup>
  <Accordion title="clickup_create_folder">
    Create folders to organize tasks and projects
  </Accordion>

  <Accordion title="clickup_get_folder">
    Get details about a specific folder
  </Accordion>

  <Accordion title="clickup_update_folder">
    Update folder settings and properties
  </Accordion>
</AccordionGroup>

### Tags

<AccordionGroup>
  <Accordion title="clickup_add_tag_to_task">
    Add tags to tasks for organization
  </Accordion>

  <Accordion title="clickup_remove_tag_from_task">
    Remove tags from tasks
  </Accordion>
</AccordionGroup>

### Members

<AccordionGroup>
  <Accordion title="clickup_get_workspace_members">
    List all members in the workspace
  </Accordion>

  <Accordion title="clickup_find_member_by_name">
    Find workspace members by name
  </Accordion>

  <Accordion title="clickup_resolve_assignees">
    Resolve assignee names to user IDs
  </Accordion>
</AccordionGroup>

### Chat

<AccordionGroup>
  <Accordion title="clickup_get_chat_channels">
    List available chat channels
  </Accordion>

  <Accordion title="clickup_send_chat_message">
    Send messages to team chat channels
  </Accordion>
</AccordionGroup>

### Documents

<AccordionGroup>
  <Accordion title="clickup_create_document">
    Create documents for project documentation
  </Accordion>

  <Accordion title="clickup_list_document_pages">
    List all pages in a document
  </Accordion>

  <Accordion title="clickup_get_document_pages">
    Get content from document pages
  </Accordion>

  <Accordion title="clickup_create_document_page">
    Add pages to existing documents
  </Accordion>

  <Accordion title="clickup_update_document_page">
    Update existing document pages
  </Accordion>
</AccordionGroup>

## Use Cases

### Sprint Generation

"Create a new folder called 'Sprint 23' in Team Space, then create 5 tasks in it: Implement user authentication (high priority, assigned to me), Design dashboard mockups (urgent), Write API documentation, Fix bug #234, Review pull requests. Set due dates for next Friday and tag them all with 'sprint-23'"

### Team Standup Preparation

"Show me all tasks assigned to me that are 'in progress' status. Then for each task, add a comment with today's progress update. Also show me which tasks are due this week."

### Documentation Sync

"Create a document called 'API Endpoints Documentation'. Find all tasks tagged 'api-endpoint' in the current sprint. For each task, create a page in the document with the task name as title and the task description as content."

<Note>
  **Chat Features:** You can send chat messages, but reading messages and creating new channels are not yet available via MCP.

  **Server Updates:** ClickUp's MCP server is undergoing active development. Any changes to the remote server may require updates on the Civic side.
</Note>

<Warning>
  **Known Issues:**

  * Time management tools are currently failing (bug report sent to ClickUp)
  * Update Bulk Task tool fails (bug report sent to ClickUp)
  * Attach tool's "upload from URL" mode does not work (base64 upload works fine)

  These tools remain available in Civic with the expectation that ClickUp will fix these issues soon.
</Warning>

***

## Guardrails

This server supports all [14 universal guardrails](/civic/concepts/guardrails). Server-specific guardrails are coming soon.
