← Back to Skills Marketplace
18502
Downloads
6
Stars
0
Active Installs
10
Versions
Install in OpenClaw
/install asana-api
Description
Asana API integration with managed OAuth. Access tasks, projects, workspaces, users, and manage webhooks. Use this skill when users want to manage work items, track projects, or integrate with Asana 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 this only if you intend to let Maton connect to your Asana account. Review connection scope during OAuth, approve writes only after checking the target resource and payload, and prefer the CLI/OAuth flow over long-lived API keys.
Capability Assessment
Credentials
The skill requires network access, Bash, and a Maton account, which is proportionate for an external Asana API integration; the raw HTTP fallback is broader but clearly limited to environments where the CLI cannot be installed.
Install Mechanism
Installation is limited to standard Maton CLI installation via npm or Homebrew, with no bundled executable scripts in the artifact.
Instruction Scope
The instructions default to read/list calls, require explicit user approval for connection creation and all writes, warn against acting on untrusted API content, and tell agents to pin the intended connection when ambiguous.
Persistence & Privilege
Authentication persists through the Maton profile and operating system credential store, but the skill explicitly instructs agents not to read, print, export, or persist credentials outside the approved mechanism.
Purpose & Capability
The documented capabilities match the stated purpose: listing and managing Asana tasks, projects, workspaces, users, and webhooks through the Maton gateway.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install asana-api - After installation, invoke the skill by name or use
/asana-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.2.0
Appendix drops the raw curl example; SkillSpector 2.11 static findings addressed across the reference; HTTP blocks replaced with maton api
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.6
- Removed the file `skill-card.md`.
- No changes were made to the skill functionality or documentation aside from this file removal.
v1.0.5
- Added CLI commands as examples throughout documentation for common tasks (listing, creating, updating, deleting tasks and projects).
- Included installation instructions for Maton CLI via NPM and Homebrew.
- Documented CLI-based authentication and connection management workflows alongside Python examples.
- Clarified how to specify active connections and pass connection IDs for multi-account setups.
- No API changes; documentation now caters to both CLI and Python workflows for improved accessibility.
v1.0.4
- Switched all endpoint references from gateway.maton.ai and ctrl.maton.ai to api.maton.ai for unified API access.
- Updated Quick Start and all example requests to use the new base URL (https://api.maton.ai).
- Clarified connection management instructions and URLs; connections are now managed at https://api.maton.ai.
- Added a specific security & permissions section requiring explicit user approval for all write operations.
- Improved documentation clarity and emphasized always specifying the Maton-Connection header when using multiple connections.
- Removed the LICENSE.txt file.
v1.0.3
- Added clawdbot metadata with emoji and required environment variable (MATON_API_KEY) in SKILL.md.
- No functional or documentation changes to the Asana API integration itself.
v1.0.2
No changes detected in this release.
- Version 1.0.2 is functionally identical to the previous version.
v1.0.1
- Added a note in the description recommending the use of the api-gateway skill for other third-party apps.
- Replaced all shell/bash `curl` API usage examples with equivalent Python code snippets using `urllib.request`, making interacting with the API in Python easier.
- Updated the authentication instructions to reference shell variable syntax (`$MATON_API_KEY`).
- No changes to API endpoints or core functionality.
v1.0.0
- Major update: Migration from local/personal OAuth CLI integration to a managed cloud API gateway and centralized connection flow.
- Removed all local scripts, code, and markdown reference files for CLI-based Asana usage.
- Documentation rewritten for Maton cloud gateway: all API calls routed via https://gateway.maton.ai/asana/ with automatic OAuth and streamlined API key auth.
- Added instructions and examples for managing Asana OAuth connections through the Maton control panel at https://ctrl.maton.ai.
- Provided modern API usage examples for accessing and managing Asana tasks, projects, workspaces, and users via HTTP and curl.
- Introduced support for specifying connections and multiple account management via headers.
- Added complete quick start, authentication, and API reference sections for ease of use.
Metadata
Frequently Asked Questions
What is Asana?
Asana API integration with managed OAuth. Access tasks, projects, workspaces, users, and manage webhooks. Use this skill when users want to manage work items, track projects, or integrate with Asana 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 18502 downloads so far.
How do I install Asana?
Run "/install asana-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Asana free?
Yes, Asana is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Asana support?
Asana is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Asana?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.1.
More Skills