What can you do with it?

The Asana integration enables comprehensive project management including workspaces, projects, and tasks. You can list all workspaces, retrieve projects within workspaces, create new tasks with assignments and due dates, query tasks with filtering options, and update task status. This integration is perfect for teams looking to automate their project workflows, track task progress, and maintain organized project structures across multiple workspaces.

How to use it?

Basic Command Structure

/your-asana-connection [action] [required-parameters] [optional-parameters]

Parameters

Required:

  • action - The operation you want to perform (list_workspaces, get_projects, create_task, query_tasks, update_task)

Optional:

  • workspace_id - Workspace identifier for project operations
  • project_id - Project identifier for task operations
  • task_id - Task identifier for update operations

Tools

List Workspaces

Retrieve all workspaces accessible to your account

Parameters:

  • action (required) - Set to “list_workspaces”

Example:

/your-asana-connection
action: list_workspaces

Response:

{
  "data": "[Array of workspace objects with gid, name, and resource_type]"
}

Get Projects in Workspace

Retrieve all projects within a specific workspace

Parameters:

  • action (required) - Set to “get_projects”
  • workspace_id (required) - The workspace identifier

Example:

/your-asana-connection
action: get_projects
workspace_id: 1208925756582198

Response:

{
  "data": "[Array of project objects with gid, name, resource_type, and workspace info]"
}

Create Task

Create a new task in a project

Parameters:

  • action (required) - Set to “create_task”
  • name (required) - Task name
  • workspace (required) - Workspace ID
  • projects (optional) - Array of project IDs to add task to
  • assignee (optional) - User ID to assign task to
  • due_on (optional) - Due date in YYYY-MM-DD format

Example:

/your-asana-connection
action: create_task
name: Design Weekly Report
workspace: 12345
projects: 123456
assignee: user_id_here
due_on: 2024-02-15

Response:

{
  "data": {
    "gid": "[Created task ID]",
    "name": "[Task name]",
    "resource_type": "task",
    "created_at": "[Creation timestamp]"
  }
}

Query Tasks in Project

Retrieve tasks from a specific project with optional filtering

Parameters:

  • action (required) - Set to “query_tasks”
  • project_id (required) - The project identifier
  • completed (optional) - Filter by completion status (true/false)
  • assignee (optional) - Filter by assignee user ID

Example:

/your-asana-connection
action: query_tasks
project_id: 123456
completed: false
assignee: user123

Response:

{
  "data": "[Array of task objects with gid, name, completed status, and assignee info]"
}

Update Task Status

Update the completion status of a task

Parameters:

  • action (required) - Set to “update_task”
  • task_id (required) - The task identifier
  • completed (required) - New completion status (true/false)

Example:

/your-asana-connection
action: update_task
task_id: 345678
completed: true

Response:

{
  "data": {
    "gid": "[Task ID]",
    "name": "[Task name]",
    "completed": "[New completion status]",
    "completed_at": "[Completion timestamp if completed]"
  }
}

Notes

Asana uses string-based GIDs (Global IDs) for all resources including workspaces, projects, and tasks. User identification can be done using “me”, an email address, or a user GID. Tasks can be assigned to multiple projects simultaneously. Due dates should be provided in YYYY-MM-DD format. When querying tasks, you can filter by completion status and assignee to narrow down results. All timestamps are returned in ISO 8601 format.