asana

---
name: asana
description: "Manage Asana via the Asana REST API. Use when you need to list workspaces, projects, tasks, search tasks, comment, update, complete, or create tasks."
metadata:
  openclaw:
    homepage: "https://developers.asana.com/docs"
    primaryEnv: "ASANA_PAT"
    requires:
      bins: ["node"]
      env: []
---

# Asana

This skill provides a lightweight Asana CLI for OpenClaw.

## Auth

Recommended auth is **PAT-first**.

Priority order:
1. `--token` or `ASANA_PAT`
2. `~/.openclaw/asana/config.json` with `{ "pat": "..." }`
3. OAuth token at `~/.openclaw/asana/token.json`

OAuth remains supported for advanced use, but PAT is the preferred local/operator setup.

## Setup

### PAT mode (recommended)

```bash
node scripts/configure.mjs --mode pat --pat "$ASANA_PAT"
```

Or set `ASANA_PAT` in OpenClaw skill config.

### OAuth mode (optional)

```bash
node scripts/configure.mjs --mode oauth --client-id "$ASANA_CLIENT_ID" --client-secret "$ASANA_CLIENT_SECRET"
node scripts/oauth_oob.mjs authorize --client-id "$ASANA_CLIENT_ID"
node scripts/oauth_oob.mjs token --client-id "$ASANA_CLIENT_ID" --client-secret "$ASANA_CLIENT_SECRET" --code "..."
```

## Storage

This skill stores local state under:

- `~/.openclaw/asana/config.json`
- `~/.openclaw/asana/token.json`

## Commands

Core CLI:

```bash
node scripts/asana_api.mjs me
node scripts/asana_api.mjs list-workspaces
node scripts/asana_api.mjs set-default-workspace --workspace <gid>
node scripts/asana_api.mjs projects --workspace <gid>
node scripts/asana_api.mjs tasks-in-project --project <gid>
node scripts/asana_api.mjs tasks-assigned --workspace <gid> --assignee me
node scripts/asana_api.mjs search-tasks --workspace <gid> --text "quote"
node scripts/asana_api.mjs task <task_gid>
node scripts/asana_api.mjs update-task <task_gid> --name "New name"
node scripts/asana_api.mjs complete-task <task_gid>
node scripts/asana_api.mjs comment <task_gid> --text "Done"
node scripts/asana_api.mjs create-task --worksp