Skip to content
asana logo

Asana (Clawdbot skill)

asana

Integrate Asana with Clawdbot via the Asana REST API. Use when you need to list/search/create/update Asana tasks/projects/workspaces, or to set up Asana OAuth (authorization code grant) for a personal local-only integration (OOB/manual code paste).

SKILL.md

Full skill instructions

Asana (Clawdbot skill)

This skill is designed for a personal local-only Asana integration using OAuth with an out-of-band/​manual code paste flow.

What this skill provides

  • A small Node CLI to:
    • generate the Asana authorize URL
    • exchange an authorization code for access/​refresh tokens
    • auto-refresh the access token
    • make basic API calls (e.g. /​users/​me, /​workspaces, tasks)

Setup (OAuth, OOB/​manual code)

0) Create an Asana app

In Asana Developer Console (My apps):

  • Create app
  • Enable scopes you will need (typical: tasks:read, tasks:write, projects:read)
  • Set redirect URI to the OOB value (manual code):
    • urn:ietf:wg:oauth:2.0:oob

1) Provide credentials (two options)

Option A (recommended for Clawdbot): save to a local credentials file:

node scripts/​configure.mjs --client-id "..." --client-secret "..."

This writes ~/​.clawdbot/​asana/​credentials.json.

Option B: set environment variables (shell/​session):

  • ASANA_CLIENT_ID
  • ASANA_CLIENT_SECRET

2) Run OAuth

From the repo root:

  1. Print the authorize URL:
node scripts/​oauth_oob.mjs authorize
  1. Open the printed URL, click Allow, copy the code.
  2. Exchange code and save tokens locally:
node scripts/​oauth_oob.mjs token --code "PASTE_CODE_HERE"

Tokens are stored at:

  • ~/​.clawdbot/​asana/​token.json

Chat usage (support both explicit + natural language)

You can use either:

  • Explicit commands: start the message with /​asana ...
  • Natural language: e.g. “list tasks assigned to me”

For Clawdbot, implement the mapping by translating the user request into the appropriate asana_api.mjs command.

Examples:

  • /​asana tasks-assigned → tasks-assigned --assignee me
  • “list tasks assigned to me” → tasks-assigned --assignee me
  • “list all tasks in <project>” → resolve <project> to a project gid, then tasks-in-project --project <gid>
  • “list tasks due date from 2026-01-01 to 2026-01-15” → search-tasks --assignee me --due_on.after 2026-01-01 --due_on.before 2026-01-15

(Optional helper) scripts/​asana_chat.mjs can map common phrases to a command skeleton.

Using the API helper

Sanity check (who am I):

node scripts/​asana_api.mjs me

List workspaces:

node scripts/​asana_api.mjs workspaces

Set a default workspace (optional):

node scripts/​asana_api.mjs set-default-workspace --workspace <workspace_gid>

After that, you can omit --workspace for commands that support it.

List projects in a workspace (explicit):

node scripts/​asana_api.mjs projects --workspace <workspace_gid>

List projects using the default workspace:

node scripts/​asana_api.mjs projects

List tasks in a project:

node scripts/​asana_api.mjs tasks-in-project --project <project_gid>

List tasks assigned to me (workspace required by Asana):

node scripts/​asana_api.mjs tasks-assigned --workspace <workspace_gid> --assignee me

Or using the default workspace:

node scripts/​asana_api.mjs tasks-assigned --assignee me

Search tasks (advanced search):

node scripts/​asana_api.mjs search-tasks --workspace <workspace_gid> --text "release" --assignee me
# also supports convenience: --project <project_gid>

View a task:

node scripts/​asana_api.mjs task <task_gid>

Mark a task complete:

node scripts/​asana_api.mjs complete-task <task_gid>

Update a task:

node scripts/​asana_api.mjs update-task <task_gid> --name "New title" --due_on 2026-02-01

Comment on a task:

node scripts/​asana_api.mjs comment <task_gid> --text "Update: shipped"

Create a task:

node scripts/​asana_api.mjs create-task --workspace <workspace_gid> --name "Test task" --notes "from clawdbot" --projects <project_gid>

Notes / gotchas

  • OAuth access tokens expire; refresh tokens are used to obtain new access tokens.
  • If you later want multi-user support, replace OOB with a real redirect/​callback.
  • Don’t log tokens.

More Productivity & Planning skills

brainstorming logo
Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K
View
ui-ux-pro-max logo
Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K
View
writing-plans logo
Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K
View
using-superpowers logo
Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K
View
executing-plans logo
Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K
View
dispatching-parallel-agents logo
Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K
View
using-git-worktrees logo
Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K
View
webapp-testing logo
Productivity & Planning

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K
View
content-strategy logo
Productivity & Planning

content-strategy

Plan searchable and shareable content that drives traffic, builds authority, and generates leads.

53.3K 150.9K
View
repo-intake-and-plan logo
Productivity & Planning

repo-intake-and-plan

README-first repository scanner that extracts commands and classifies reproduction candidates without executing them.

497 139.6K
View
marketing-ideas logo
Productivity & Planning

marketing-ideas

Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.

53.3K 137.2K
View
site-architecture logo
Productivity & Planning

site-architecture

Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.

53.3K 112.8K
View

Productivity AI tools

Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View
SaveDay logo
Productivity

SaveDay

Capture, organize, and utilize your knowledge effortlessly.

Free
View
Any Summary logo
Productivity

Any Summary

Instant Summaries of Audio & Video Interviews with AnySummary

Freemium
View
M
Productivity

Map This

Transform PDFs into engaging mind maps.

Freemium
View
ChatPDF logo
Productivity

ChatPDF

Chat with any PDF instantly

Free
View
I
Productivity

intellisay

Create an optimal daily plan using your voice

Paid
View
A
Productivity

Aurora AI

A productivity platform to centralize organizational knowledge and workflows with contextual AI assistance.

Paid
View
AskYourPDF logo
Productivity

AskYourPDF

AskYourPDF Pricing Plans: Tailored to Your Needs

Free
View