# Asana
Full Asana REST API integration for task & project management. Powers the Master Calendar pipeline.
## Setup
Run once to store your Personal Access Token:
```bash
python3 ~/.hermes/skills/productivity/asana/scripts/setup.py --token "YOUR_ASANA_PAT"
```
Get a token at: https://app.asana.com/0/my-apps
## Usage
Set a shorthand:
```bash
ASANA="python3 ~/.hermes/skills/productivity/asana/scripts/asana_cli.py"
```
### Tasks
```bash
# Create a task
$ASANA task create --name "Review Q4 deck" --project 1216602500278026 --due 2026-07-20
$ASANA task create --name "Call dentist" --project 1216602500278026 --due 2026-07-18 --notes "Dr. Smith, 312-555-0100" --section "Daily"
# Create with NPAO metadata in notes
$ASANA task create --name "Fix login bug" --project 1216602500278026 --due today \
--notes "phase:debug|priority:9.2|impact:revenue|source:hermes"
# List tasks (with filters)
$ASANA task list --project 1216602500278026
$ASANA task list --project 1216602500278026 --due-today
$ASANA task list --project 1216602500278026 --due-this-week
$ASANA task list --project 1216602500278026 --due-on 2026-07-20
$ASANA task list --project 1216602500278026 --incomplete
$ASANA task list --project 1216602500278026 --section "Daily"
# Get task details
$ASANA task get TASK_GID
# Update task
$ASANA task update TASK_GID --name "New name" --due 2026-07-25 --completed
$ASANA task update TASK_GID --notes "Updated notes"
$ASANA task update TASK_GID --section SECTION_GID
# Delete task
$ASANA task delete TASK_GID
# Search across workspace
$ASANA task search --workspace 1206772437471958 --text "Q4 budget"
```
### Projects
```bash
# List projects in workspace
$ASANA project list --workspace 1206772437471958
# Get project
$ASANA project get 1216602500278026
# Update project (default view, name, etc.)
$ASANA project update 1216602500278026 --default-view calendar
$ASANA project update 1216602500278026 --name "New Name"
```
### Sections
```bash
# List sections
$ASANA section list --project 1216602500278026
# Create section
$ASANA section create --project 1216602500278026 --name "This Week"
```
### Calendar Operations
```bash
# Get all tasks for a date range (calendar view)
$ASANA calendar range --project 1216602500278026 --start 2026-07-15 --end 2026-07-21
# Get today's tasks
$ASANA calendar today --project 1216602500278026
# Upcoming tasks (next N days)
$ASANA calendar upcoming --project 1216602500278026 --days 7
```
## Output Format
All commands return JSON arrays. Parse with jq:
- **task list**: `[{gid, name, due_on, completed, assignee, notes, section, permalink_url}]`
- **task create**: `{gid, name, due_on, permalink_url}`
- **task get**: `{gid, name, due_on, completed, notes, assignee, section, projects, permalink_url, created_at}`
- **project get**: `{gid, name, default_view, sections, permalink_url}`
- **calendar range**: `[{gid, name, due_on, completed, section_name}]`
## NPAO Integration
When creating tasks from Hermes, the `--notes` field carries NPAO metadata:
```
phase:debug|priority:9.2|impact:revenue|source:hermes
```
Supported tags:
- `phase`: pred | design | dev | deploy | debug
- `priority`: 0.0-10.0 (NPAO composite score)
- `impact`: revenue | ux | team | internal | nice
- `source`: email | hermes | gcal | manual
- `blocked_by`: TASK_GID
- `est_hours`: float
## Reference
- Asana API docs: https://developers.asana.com/reference/rest-api-reference
- Master Calendar project: https://app.asana.com/0/1206772437471958/1216602500278026
Asana
LLM-agnostic AI agent development skill that instructs any AI model (Claude, GPT-4o, Gemini, Cursor) to work with Asana Personal Access Token (stored in skill dir). Use when worki…
AI Agentsv1.0.0UniversalFreeAgent Skills spec