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.
uv pip install agno requests openaiexport CLICKUP_API_KEY="your_api_key"
export MASTER_SPACE_ID="your_workspace_id"Example
The following agent can manage ClickUp tasks and projects:
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 the first page of tasks from each folderless list 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.
Listing and creation scope
The toolkit queries folderless lists in each space. It does not traverse lists inside folders or paginate each list's tasks. Task creation selects the first returned folderless list; use the provider API directly when you need to choose a different list.