Asana Integration

Pro v1.0.0

Manage Asana tasks, projects, and workspaces programmatically using the official Python SDK

Requires Claude Code CLI

This skill integrates with Asana through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

List Workspaces

Get all workspaces you have access to

Returns

array List of workspaces with GIDs

Try saying...

  • "Show me my Asana workspaces"
  • "List all workspaces"
  • "What workspaces do I have access to?"

Get User Info

Display information about the authenticated user

Returns

object Current user information including workspaces

Try saying...

  • "Who am I logged in as?"
  • "Show my Asana user info"
  • "What workspaces am I part of?"

List Tasks

List all tasks assigned to you, optionally filtered by workspace

Parameters

Name Type Required Description
workspace_gid string Optional Workspace GID to filter tasks

Returns

array List of tasks with completion status, due dates, and projects

Try saying...

  • "Show me my Asana tasks"
  • "List my tasks in workspace 123456789"
  • "What tasks are assigned to me?"

Create Task

Create a new task in a workspace, optionally adding it to a project

Parameters

Name Type Required Description
name string Required Task name
workspace_gid string Required Workspace GID
project_gid string Optional Project GID to add task to

Returns

object Created task with GID and permalink

Try saying...

  • "Create an Asana task called 'Review PR' in workspace 123456789"
  • "Add a new task to project 987654321"
  • "Create a task named 'Design mockups'"

Get Task

View detailed information about a specific task

Parameters

Name Type Required Description
task_gid string Required Task GID

Returns

object Task details including assignee, due date, notes, projects, and tags

Try saying...

  • "Show me details for task 987654321"
  • "Get task 1234567890123456"
  • "What are the details of this task?"

Update Task

Update a field on an existing task

Parameters

Name Type Required Description
task_gid string Required Task GID
field string Required Field name to update
value string Required New value for the field

Returns

object Updated task confirmation

Try saying...

  • "Update task 987654321 to set due date to 2025-01-15"
  • "Change task name to 'Updated name'"
  • "Set task notes to 'New description'"

Complete Task

Mark a task as complete

Parameters

Name Type Required Description
task_gid string Required Task GID

Returns

object Completion confirmation

Try saying...

  • "Mark task 987654321 as complete"
  • "Complete task 1234567890123456"
  • "Finish this task"

List Projects

List all projects in a workspace

Parameters

Name Type Required Description
workspace_gid string Required Workspace GID

Returns

array List of projects with GIDs and archived status

Try saying...

  • "Show me projects in workspace 123456789"
  • "List all projects"
  • "What projects are in my workspace?"

Create Project

Create a new project in a workspace

Parameters

Name Type Required Description
name string Required Project name
workspace_gid string Required Workspace GID

Returns

object Created project with GID and permalink

Try saying...

  • "Create an Asana project called 'Q1 Planning' in workspace 123456789"
  • "Add a new project to workspace 1234567890123"
  • "Create a project named 'Marketing Campaign'"

Getting Started

API Key Easy Setup
  1. 1 Go to Asana Developer Console at https://app.asana.com/0/my-apps
  2. 2 Click 'Create new token'
  3. 3 Give it a descriptive name (e.g., 'Claude Code Integration')
  4. 4 Copy the token (shown only once)
  5. 5 Add to shell config: echo 'export ASANA_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
  6. 6 Restart terminal or run: source ~/.zshrc

Verify Setup

python scripts/client.py get-user

Success: Displays your name and workspaces

View full setup guide

Security & Access

Access Scope

Full access to all Asana data the user can access, including tasks, projects, workspaces, and private information

  • Personal Access Token grants full access to your Asana account
  • Token can read all private tasks and confidential information
  • Token can create, update, and delete tasks and projects
  • Store token securely - never commit to version control
  • Regularly audit active tokens and revoke unused ones

Limitations

  • Requires workspace/project GIDs which must be obtained via list commands first
  • Task updates are limited to one field at a time via this client
  • Personal Access Tokens have the same permissions as the user account

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
PYTHON_SDK
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
asana>=5.0.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements