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

# ClickUp

> ClickUpTools enables agents to interact with ClickUp workspaces for project management and task organization.

## Prerequisites

The following example requires the `requests` and `openai` libraries.

```shell theme={null}
uv pip install requests openai
```

```shell theme={null}
export CLICKUP_API_KEY="your_api_key"
export MASTER_SPACE_ID="your_workspace_id"
```

## Example

The following agent can manage ClickUp tasks and projects:

```python theme={null}
from agno.agent import Agent
from agno.tools.clickup import ClickUpTools

agent = Agent(
    instructions=[
        "You are a ClickUp project management assistant",
        "Help users manage their tasks, projects, and workspaces",
        "Create, update, and organize tasks efficiently",
        "Provide clear status updates on task operations",
    ],
    tools=[ClickUpTools()],
)

agent.print_response("Create a new task called 'Review documentation' in the Team Space", stream=True)
```

## Toolkit Params

| Parameter | Type | Default | Description |
| - | - | - | - |
| `api_key` | `Optional[str]` | `None` | ClickUp API key. Uses CLICKUP\_API\_KEY if not set. |
| `master_space_id` | `Optional[str]` | `None` | ClickUp workspace (team) ID. Uses MASTER\_SPACE\_ID if not set. |
| `timeout` | `int` | `30` | Request timeout in seconds. |

## Toolkit Functions

| Function | Description |
| - | - |
| `list_tasks` | List all tasks in a space. |
| `create_task` | Create a new task in a space with a name and description. |
| `get_task` | Get detailed information about a specific task. |
| `update_task` | Update an existing task's properties. |
| `delete_task` | Delete a task from ClickUp. |
| `list_spaces` | List all spaces in the workspace. |
| `list_lists` | List all lists in a space. |

You can use `include_tools` or `exclude_tools` to modify the list of tools the agent has access to. Learn more about [selecting tools](https://agno-v2.mintlify.site/tools/selecting-tools.md).

## Developer Resources

* [Tools Source](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/clickup.py)
* [ClickUp API Documentation](https://clickup.com/api/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.