← Back to Skills Marketplace
18755
Downloads
12
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install clickup-api
Description
ClickUp API integration with managed OAuth. Access tasks, lists, folders, spaces, workspaces, users, and manage webhooks. Use this skill when users want to manage work items, track projects, or integrate with ClickUp workflows. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login; default to read and list calls, and confirm every write or new connection with the user.
Usage Guidance
Install only if you want Maton to broker access to your ClickUp account. Use OAuth when possible, approve connection creation yourself, review every proposed write/delete/webhook action before confirming it, and revoke unused Maton connections when finished.
Capability Assessment
Credentials
Network access, Bash use, and ClickUp API calls are proportionate to the integration purpose; the raw API passthrough is scoped to ClickUp paths and paired with write-confirmation guidance.
Install Mechanism
Installation requires the third-party Maton CLI via npm or Homebrew, which is disclosed and purpose-aligned but means users must trust that external CLI and gateway.
Instruction Scope
The skill repeatedly instructs agents to default to read/list calls, confirm connection creation, confirm every POST/PUT/PATCH/DELETE, specify the intended connection when ambiguous, and treat ClickUp-returned content as untrusted data.
Persistence & Privilege
OAuth/API credentials and ClickUp connections persist in Maton/OS credential storage, but this is disclosed and the skill explicitly says not to inspect, print, export, or persist secrets elsewhere.
Purpose & Capability
The stated purpose is ClickUp project/work-item management, and the documented capabilities match that purpose: reading teams, spaces, folders, lists, tasks, users, and managing webhooks through Maton.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clickup-api - After installation, invoke the skill by name or use
/clickup-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.5
No changes detected in this version.
- Version updated to 1.0.5, but no file or documentation changes are present.
v1.0.4
- Updated all ClickUp API endpoints to use https://api.maton.ai instead of https://gateway.maton.ai.
- Updated connection management URLs and examples to https://api.maton.ai.
- Improved security section, clarifying required user approval for all write actions.
- Removed sample LICENSE.txt file from the repository.
v1.0.3
Version 1.0.3
- Added new `clawdbot` metadata section specifying an emoji and required environment variable (`MATON_API_KEY`).
- No code or logic changes; documentation only updated with additional metadata.
- Existing API usage and functionality remain unchanged.
v1.0.2
- No file changes detected in this release.
- Documentation and skill metadata remain unchanged.
- No functional or API updates were made for version 1.0.2.
v1.0.1
- Updated usage examples to use Python scripts instead of curl for easier automation and cross-platform compatibility.
- Improved documentation with Python code snippets for all connection management and API request examples.
- Added a reference to the api-gateway skill for integrating with other third party apps.
- Clarified environment variable usage in authentication sections.
v1.0.0
- Major update: Migrated ClickUp integration to Maton gateway with managed OAuth.
- Legacy helper scripts and standalone token config removed; now uses centralized, secure OAuth connections.
- Unified API endpoint: All requests proxy through `https://gateway.maton.ai/clickup/{native-api-path}`.
- Centralized connection management added via `https://ctrl.maton.ai` (list, create, delete ClickUp OAuth connections).
- Updated documentation with concise API usage, ClickUp hierarchy, and improved authentication instructions.
- Deprecated detailed code samples, troubleshooting, and low-level scripting in favor of streamlined REST API calls.
Metadata
Frequently Asked Questions
What is ClickUp?
ClickUp API integration with managed OAuth. Access tasks, lists, folders, spaces, workspaces, users, and manage webhooks. Use this skill when users want to manage work items, track projects, or integrate with ClickUp workflows. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login; default to read and list calls, and confirm every write or new connection with the user. It is an AI Agent Skill for Claude Code / OpenClaw, with 18755 downloads so far.
How do I install ClickUp?
Run "/install clickup-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ClickUp free?
Yes, ClickUp is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does ClickUp support?
ClickUp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ClickUp?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.0.
More Skills