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