clickup

What This Skill Does

The ClickUp skill for OpenClaw provides a secure, streamlined interface to the ClickUp REST API using managed OAuth. By utilizing the Maton.ai gateway, this skill handles the complexities of token management, allowing users to programmatically interact with their entire ClickUp workspace structure, including tasks, lists, folders, and custom webhooks. It abstracts the need to manually manage ClickUp OAuth flows, making it ideal for automation agents that require persistent access to project management data.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/byungkyu/clickup-api

Ensure that you have set your MATON_API_KEY as an environment variable before attempting to make requests. You can obtain your API key by registering at maton.ai and navigating to the settings dashboard. If you need to establish a new connection to a specific ClickUp account, use the provided connection management endpoints to initialize the OAuth flow.

Use Cases

• Project Automation: Automatically create tasks in ClickUp when an AI agent detects a new project requirement in a conversation or external log.
• Status Syncing: Query your ClickUp workspace to provide stakeholders with automated progress reports or summaries of pending tasks.
• Workflow Orchestration: Utilize webhooks to trigger downstream actions in other systems whenever a task status changes to 'Complete'.
• Administrative Management: Efficiently manage user access, space configurations, and team assignments across large organizations.

Example Prompts

1. "Check my pending tasks in the 'Development' list and summarize the top three priorities for today."
2. "Create a new task in the 'Q1 Roadmap' folder titled 'Draft API Documentation' with a due date of next Friday."
3. "List all active workspaces connected to my account and provide the status of each connection."

Tips & Limitations

• Gateway Efficiency: Always route requests through https://gateway.maton.ai/clickup/ to benefit from automatic authentication injection.
• Connection State: If you encounter authentication errors, verify that your connection status is 'ACTIVE' by querying the ctrl.maton.ai endpoint.
• Rate Limiting: Remember that all requests are governed by ClickUp's native API rate limits; consider implementing back-off logic in scripts that perform bulk updates.
• Security: Never hardcode your MATON_API_KEY in scripts; always reference it via os.environ or a secure secret manager.