Asana Automation via Rube MCP

Automate Asana operations through Composio's Asana toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/asana

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)

• Active Asana connection via RUBE_MANAGE_CONNECTIONS with toolkit asana

• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

• Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds

• Call RUBE_MANAGE_CONNECTIONS with toolkit asana

• If connection is not ACTIVE, follow the returned auth link to complete Asana OAuth

• Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Manage Tasks

When to use: User wants to create, search, list, or organize tasks

Tool sequence:

• ASANA_GET_MULTIPLE_WORKSPACES

• Get workspace ID [Prerequisite]

• ASANA_SEARCH_TASKS_IN_WORKSPACE

• Search tasks [Optional]

• ASANA_GET_TASKS_FROM_A_PROJECT

• List project tasks [Optional]

• ASANA_CREATE_A_TASK

• Create a new task [Optional]

• ASANA_GET_A_TASK

• Get task details [Optional]

• ASANA_CREATE_SUBTASK

• Create a subtask [Optional]

• ASANA_GET_TASK_SUBTASKS

• List subtasks [Optional]

Key parameters:

• workspace : Workspace GID (required for search/creation)

• projects : Array of project GIDs to add task to

• name : Task name

• notes : Task description

• assignee : Assignee (user GID or email)

• due_on : Due date (YYYY-MM-DD)

Pitfalls:

• Workspace GID is required for most operations; get it first

• Task GIDs are returned as strings, not integers

• Search is workspace-scoped, not project-scoped

2. Manage Projects and Sections

When to use: User wants to create projects, manage sections, or organize tasks

Tool sequence:

• ASANA_GET_WORKSPACE_PROJECTS

• List workspace projects [Optional]

• ASANA_GET_A_PROJECT

• Get project details [Optional]

• ASANA_CREATE_A_PROJECT

• Create a new project [Optional]

• ASANA_GET_SECTIONS_IN_PROJECT

• List sections [Optional]

• ASANA_CREATE_SECTION_IN_PROJECT

• Create a new section [Optional]

• ASANA_ADD_TASK_TO_SECTION

• Move task to section [Optional]

• ASANA_GET_TASKS_FROM_A_SECTION

• List tasks in section [Optional]

Key parameters:

• project_gid : Project GID

• name : Project or section name

• workspace : Workspace GID for creation

• task : Task GID for section assignment

• section : Section GID

Pitfalls:

• Projects belong to workspaces; workspace GID is needed for creation

• Sections are ordered within a project

• DUPLICATE_PROJECT creates a copy with optional task inclusion

3. Manage Teams and Users

When to use: User wants to list teams, team members, or workspace users

Tool sequence:

• ASANA_GET_TEAMS_IN_WORKSPACE

• List workspace teams [Optional]

• ASANA_GET_USERS_FOR_TEAM

• List team members [Optional]

• ASANA_GET_USERS_FOR_WORKSPACE

• List all workspace users [Optional]

• ASANA_GET_CURRENT_USER

• Get authenticated user [Optional]

• ASANA_GET_MULTIPLE_USERS

• Get multiple user details [Optional]

Key parameters:

• workspace_gid : Workspace GID

• team_gid : Team GID

Pitfalls:

• Users are workspace-scoped

• Team membership requires the team GID

4. Parallel Operations

When to use: User needs to perform bulk operations efficiently

Tool sequence:

• ASANA_SUBMIT_PARALLEL_REQUESTS
• Execute multiple API calls in parallel [Required]

Key parameters:

• actions : Array of action objects with method, path, and data

Pitfalls:

• Each action must be a valid Asana API call

• Failed individual requests do not roll back successful ones

Common Patterns

ID Resolution

Workspace name -> GID:

1. Call ASANA_GET_MULTIPLE_WORKSPACES
2. Find workspace by name
3. Extract gid field

Project name -> GID:

1. Call ASANA_GET_WORKSPACE_PROJECTS with workspace GID
2. Find project by name
3. Extract gid field

Pagination

• Asana uses cursor-based pagination with offset parameter

• Check for next_page in response

• Pass offset from next_page.offset for next request

Known Pitfalls

GID Format:

• All Asana IDs are strings (GIDs), not integers

• GIDs are globally unique identifiers

Workspace Scoping:

• Most operations require a workspace context

• Tasks, projects, and users are workspace-scoped

Quick Reference

Task Tool Slug Key Params

List workspaces ASANA_GET_MULTIPLE_WORKSPACES (none)

Search tasks ASANA_SEARCH_TASKS_IN_WORKSPACE workspace, text

Create task ASANA_CREATE_A_TASK workspace, name, projects

Get task ASANA_GET_A_TASK task_gid

Create subtask ASANA_CREATE_SUBTASK parent, name

List subtasks ASANA_GET_TASK_SUBTASKS task_gid

Project tasks ASANA_GET_TASKS_FROM_A_PROJECT project_gid

List projects ASANA_GET_WORKSPACE_PROJECTS workspace

Create project ASANA_CREATE_A_PROJECT workspace, name

Get project ASANA_GET_A_PROJECT project_gid

Duplicate project ASANA_DUPLICATE_PROJECT project_gid

List sections ASANA_GET_SECTIONS_IN_PROJECT project_gid

Create section ASANA_CREATE_SECTION_IN_PROJECT project_gid, name

Add to section ASANA_ADD_TASK_TO_SECTION section, task

Section tasks ASANA_GET_TASKS_FROM_A_SECTION section_gid

List teams ASANA_GET_TEAMS_IN_WORKSPACE workspace_gid

Team members ASANA_GET_USERS_FOR_TEAM team_gid

Workspace users ASANA_GET_USERS_FOR_WORKSPACE workspace_gid

Current user ASANA_GET_CURRENT_USER (none)

Parallel requests ASANA_SUBMIT_PARALLEL_REQUESTS actions

Powered by Composio