> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc-redirect-agent-platform-overview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp

> Use ClickUp with Agno Agents.

Enable Agno agents to manage ClickUp tasks, spaces, and lists.

## Prerequisites

<AccordionGroup>
  *(Click for details)*

  <Accordion title="1. Get your Clickup API Key:">
    * Log In to ClickUp and navigate to Settings (usually a circle with your initials) and click on it
    * Access the Apps Section. In the settings sidebar on the left, scroll down until you find Apps. Click on it to access the API settings.
    * Generate Your API Key In the Apps section. Look for the option labeled API Key. If it’s not already generated, look for a button that says 'Generate and click it'. Once generated, your API key will be displayed.
    * To use Clickup tool, copy this key and store it as CLICKUP\_API\_KEY in the .env file.
  </Accordion>

  <Accordion title="2. Locate your MASTER_SPACE_ID:">
    * Refer to the Clickup space url structure: [https://app.clickup.com/\{MASTER\_SPACE\_ID}/v/o/s/\{SPACE\_ID}](https://app.clickup.com/\{MASTER_SPACE_ID}/v/o/s/\{SPACE_ID})
    * Copy any space url from your clickup workspace. All such urls follow the same structure listed above.
    * To use clickup tool, copy the MASTER\_SPACE\_ID and store it the .env file.
  </Accordion>
</AccordionGroup>

```python theme={null}

from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.clickup import ClickUpTools

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

clickup_agent = Agent(
    name="ClickUp Agent",
    role="Manage ClickUp tasks and spaces",
    model=OpenAIChat(id="gpt-5.2"),
    tools=[
        ClickUpTools(
            exclude_tools=[
                "create_task",
                "get_task",
                "update_task",
                "delete_task",
            ]
        )
    ],
    instructions=[
        "You are a ClickUp assistant that helps users manage their tasks and spaces.",
        "You can:",
        "1. List all available spaces",
        "2. List tasks from a specific space",
        "3. List all lists in a space",
        "4. Create new tasks with title, description, and status",
        "When creating tasks:",
        "- Always get space name, task name, and description",
        "- Status can be: todo, in progress, or done",
        "- If status is not specified, use 'todo' as default",
        "Be helpful and guide users if they need more information.",
    ],
    markdown=True,
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    clickup_agent.print_response(
        "List all spaces i have",
        markdown=True,
    )
    clickup_agent.print_response(
        "Create a task (status 'To Do') called 'QA task' in Project 1 in the Team Space. The description should be about running basic QA checks on our Python codebase.",
        markdown=True,
    )
```

## Run the Example

```bash theme={null}
# Clone and setup repo
git clone https://github.com/agno-agi/agno.git
cd agno/cookbook/91_tools

# Create and activate virtual environment
./scripts/demo_setup.sh
source .venvs/demo/bin/activate

python clickup_tools.py
```

For details, see [ClickUp cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/clickup_tools.py).