ClickUp

Use ClickUp with Agno Agents.

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

Prerequisites

(Click for details)

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.

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}
• 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.

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

# 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.