VM0VM0
Agent Skills

ClickUp

Project management and task tracking platform

ClickUp is a project management platform for managing tasks, lists, folders, spaces, and workspaces via REST API.

Required Environment

NameTypeDescription
CLICKUP_TOKENsecretAPI token from ClickUp (Avatar > Settings > Apps > API Token > Generate and copy token)

Configuration

vm0.yaml
version: "1.0"

agents:
  my-agent:
    framework: claude-code
    skills:
      - https://github.com/vm0-ai/vm0-skills/tree/main/clickup

Run

Store your secret on the platform (recommended, one-time setup):

vm0 secret set CLICKUP_TOKEN your-clickup-api-token

Then run your agent - secret is automatically loaded:

vm0 run my-agent "list all tasks in my ClickUp workspace"

For CI/CD or temporary overrides, pass secrets at runtime: --secrets CLICKUP_TOKEN=value. See Environment Variables for details.

Example Instructions

AGENTS.md
# Task Manager Agent

You manage ClickUp tasks and projects.

## Workflow

1. List workspaces and spaces
2. Create and organize tasks in lists
3. Update task status and assignees
4. Track time entries on tasks

## Key Concepts

- Hierarchy: Workspace > Space > Folder > List > Task
- Task statuses are lowercase (to do, in progress, complete)
- Priority: 1=urgent, 2=high, 3=normal, 4=low
AGENTS.md
# Project Reporter Agent

You generate reports from ClickUp data.

## Workflow

1. Get tasks filtered by status and assignee
2. Summarize task counts by status
3. List overdue tasks
4. Report time tracking data

## Filters

- statuses, assignees, due dates, tags