Manage ClickUp Tasks from Your AI Agent with the ClickUp Skill

Project management is at the heart of modern work, and ClickUp has become one of the most popular tools for organizing tasks, sprints, and team workflows. But what if your AI agent could interact with ClickUp directly — creating tasks, updating statuses, and managing your projects without you lifting a finger?

The ClickUp skill for Clawdbot brings full ClickUp API integration to your AI agent, letting you automate task management, track work across teams, and keep projects moving from the command line or through natural conversation.

Who Needs This?

This skill is perfect for:

Developers and teams using ClickUp for sprint planning and issue tracking
Project managers who want AI assistance with task creation and status updates
Automation enthusiasts building workflows that span multiple tools
Anyone tired of context-switching between their AI assistant and ClickUp

Installation

Install the ClickUp skill from ClawdHub:

npx clawhub@latest install clickup-api

Setup & Authentication

The ClickUp skill uses Maton's managed OAuth gateway, so you don't need to wrestle with API tokens or OAuth flows manually.

Step 1: Get your Maton API key

Sign up or log in at maton.ai
Go to maton.ai/settings
Copy your API key

Step 2: Set the environment variable

export MATON_API_KEY="your-api-key-here"

Step 3: Connect your ClickUp account

Create a new connection and open the returned URL in your browser to authorize:

import urllib.request, os, json
data = json.dumps({'status': 'complete'}).encode()
req = urllib.request.Request('https://gateway.maton.ai/clickup/api/v2/task/TASK_ID', data=data, method='PUT')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Understanding ClickUp's Hierarchy

ClickUp organizes data in a nested structure:

Workspace (Team) → Space → Folder → List → Task

Knowing this helps you navigate the API — workspaces contain spaces, spaces contain folders, folders contain lists, and lists contain tasks.

Usage Examples

1. List Your Workspaces

import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/clickup/api/v2/team')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

2. Create a New Task

import urllib.request, os, json
data = json.dumps({'status': 'complete'}).encode()
req = urllib.request.Request('https://gateway.maton.ai/clickup/api/v2/task/TASK_ID', data=data, method='PUT')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

3. Update Task Status

import urllib.request, os, json
data = json.dumps({'status': 'complete'}).encode()
req = urllib.request.Request('https://gateway.maton.ai/clickup/api/v2/task/TASK_ID', data=data, method='PUT')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Pro Tips

Priority values: 1=urgent, 2=high, 3=normal, 4=low, null=none
Timestamps: ClickUp uses Unix timestamps in milliseconds (not seconds!)
Status names: Must match exactly what's configured in your list
Pagination: Results are limited to 100 items per page — use ?page=0, ?page=1, etc.
Webhooks: Set up webhooks to trigger your agent when tasks change

Best Practices

Cache workspace/space/list IDs — They don't change often, so store them to avoid extra API calls
Use filters — The /team/{team_id}/task endpoint supports filtering by status, assignee, due date, and more
Handle rate limits — ClickUp has rate limits; implement retry logic with exponential backoff
Test in a sandbox — Create a test workspace before automating production tasks

Conclusion

The ClickUp skill turns your Clawdbot into a project management powerhouse. Whether you're creating tasks from Slack messages, updating statuses based on Git commits, or building complex automations, this skill gives you full programmatic access to ClickUp's capabilities.

Links:

Happy automating! 🚀