asana-automation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Asana Automation via Rube MCP

通过Rube MCP实现Asana自动化

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

Toolkit docs: composio.dev/toolkits/asana

通过Composio的Asana工具包，借助Rube MCP实现Asana操作自动化。

工具包文档：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

必须已连接Rube MCP（需提供RUBE_SEARCH_TOOLS）
通过
```
RUBE_MANAGE_CONNECTIONS
```
并使用工具包
```
asana
```
建立有效的Asana连接
请始终先调用
```
RUBE_SEARCH_TOOLS
```
以获取最新的工具架构

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

获取Rube MCP：在客户端配置中添加

https://rube.app/mcp

作为MCP服务器。无需API密钥——只需添加端点即可使用。

通过确认
```
RUBE_SEARCH_TOOLS
```
能正常响应，验证Rube MCP是否可用
调用
```
RUBE_MANAGE_CONNECTIONS
```
并指定工具包
```
asana
```
如果连接状态未处于ACTIVE，请按照返回的认证链接完成Asana OAuth授权
在运行任何工作流之前，确认连接状态显示为ACTIVE

Core Workflows

核心工作流

1. Manage Tasks

1. 任务管理

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

适用场景：用户需要创建、搜索、列出或整理任务

工具序列：

```
ASANA_GET_MULTIPLE_WORKSPACES
```
- 获取工作区ID [必备步骤]
```
ASANA_SEARCH_TASKS_IN_WORKSPACE
```
- 搜索任务 [可选]
```
ASANA_GET_TASKS_FROM_A_PROJECT
```
- 列出项目中的任务 [可选]
```
ASANA_CREATE_A_TASK
```
- 创建新任务 [可选]
```
ASANA_GET_A_TASK
```
- 获取任务详情 [可选]
```
ASANA_CREATE_SUBTASK
```
- 创建子任务 [可选]
```
ASANA_GET_TASK_SUBTASKS
```
- 列出子任务 [可选]

关键参数：

```
workspace
```
：工作区GID（搜索/创建操作必填）
```
projects
```
：要添加任务的项目GID数组
```
name
```
：任务名称
```
notes
```
：任务描述
```
assignee
```
：负责人（用户GID或邮箱）
```
due_on
```
：截止日期（格式：YYYY-MM-DD）

注意事项：

大多数操作都需要工作区GID，请先获取该ID
任务GID以字符串形式返回，而非整数
搜索范围限定为工作区，而非单个项目

2. Manage Projects and Sections

2. 项目与板块管理

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

适用场景：用户需要创建项目、管理板块或整理任务

工具序列：

```
ASANA_GET_WORKSPACE_PROJECTS
```
- 列出工作区中的项目 [可选]
```
ASANA_GET_A_PROJECT
```
- 获取项目详情 [可选]
```
ASANA_CREATE_A_PROJECT
```
- 创建新项目 [可选]
```
ASANA_GET_SECTIONS_IN_PROJECT
```
- 列出板块 [可选]
```
ASANA_CREATE_SECTION_IN_PROJECT
```
- 创建新板块 [可选]
```
ASANA_ADD_TASK_TO_SECTION
```
- 将任务移至指定板块 [可选]
```
ASANA_GET_TASKS_FROM_A_SECTION
```
- 列出板块中的任务 [可选]

关键参数：

```
project_gid
```
：项目GID
```
name
```
：项目或板块名称
```
workspace
```
：创建项目时需提供工作区GID
```
task
```
：分配至板块的任务GID
```
section
```
：板块GID

注意事项：

项目隶属于工作区，创建时需提供工作区GID
板块在项目内有固定顺序
DUPLICATE_PROJECT可创建项目副本，可选择是否包含任务

3. Manage Teams and Users

3. 团队与用户管理

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

适用场景：用户需要列出团队、团队成员或工作区用户

工具序列：

```
ASANA_GET_TEAMS_IN_WORKSPACE
```
- 列出工作区中的团队 [可选]
```
ASANA_GET_USERS_FOR_TEAM
```
- 列出团队成员 [可选]
```
ASANA_GET_USERS_FOR_WORKSPACE
```
- 列出工作区所有用户 [可选]
```
ASANA_GET_CURRENT_USER
```
- 获取当前认证用户信息 [可选]
```
ASANA_GET_MULTIPLE_USERS
```
- 获取多个用户详情 [可选]

关键参数：

```
workspace_gid
```
：工作区GID
```
team_gid
```
：团队GID

注意事项：

用户信息以工作区为范围
查询团队成员需要提供团队GID

4. Parallel Operations

4. 并行操作

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

适用场景：用户需要高效执行批量操作

工具序列：

```
ASANA_SUBMIT_PARALLEL_REQUESTS
```
- 并行执行多个API调用 [必填]

关键参数：

```
actions
```
：包含method、path和data的操作对象数组

注意事项：

每个操作必须是有效的Asana API调用
个别请求失败不会回滚已成功的请求

Common Patterns

常见模式

ID Resolution

ID解析

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

工作区名称 -> GID:

1. 调用ASANA_GET_MULTIPLE_WORKSPACES
2. 根据名称查找工作区
3. 提取gid字段

项目名称 -> GID:

1. 使用工作区GID调用ASANA_GET_WORKSPACE_PROJECTS
2. 根据名称查找项目
3. 提取gid字段

Pagination

分页处理

Asana uses cursor-based pagination with
```
offset
```
parameter
Check for
```
next_page
```
in response
Pass
```
offset
```
from
```
next_page.offset
```
for next request

Asana采用基于游标（cursor）的分页机制，使用
```
offset
```
参数
检查响应中的
```
next_page
```
字段
将
```
next_page.offset
```
的值作为下一次请求的
```
offset
```
参数

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

GID格式:

所有Asana ID均为字符串类型的全局唯一标识符（GID）
GID是全局唯一的标识符

工作区范围限定:

大多数操作都需要工作区上下文
任务、项目和用户均以工作区为范围

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

操作	工具标识	关键参数
列出工作区	ASANA_GET_MULTIPLE_WORKSPACES	无
搜索任务	ASANA_SEARCH_TASKS_IN_WORKSPACE	workspace, text
创建任务	ASANA_CREATE_A_TASK	workspace, name, projects
获取任务详情	ASANA_GET_A_TASK	task_gid
创建子任务	ASANA_CREATE_SUBTASK	parent, name
列出子任务	ASANA_GET_TASK_SUBTASKS	task_gid
列出项目任务	ASANA_GET_TASKS_FROM_A_PROJECT	project_gid
列出项目	ASANA_GET_WORKSPACE_PROJECTS	workspace
创建项目	ASANA_CREATE_A_PROJECT	workspace, name
获取项目详情	ASANA_GET_A_PROJECT	project_gid
复制项目	ASANA_DUPLICATE_PROJECT	project_gid
列出板块	ASANA_GET_SECTIONS_IN_PROJECT	project_gid
创建板块	ASANA_CREATE_SECTION_IN_PROJECT	project_gid, name
将任务添加至板块	ASANA_ADD_TASK_TO_SECTION	section, task
列出板块任务	ASANA_GET_TASKS_FROM_A_SECTION	section_gid
列出团队	ASANA_GET_TEAMS_IN_WORKSPACE	workspace_gid
列出团队成员	ASANA_GET_USERS_FOR_TEAM	team_gid
列出工作区用户	ASANA_GET_USERS_FOR_WORKSPACE	workspace_gid
获取当前用户	ASANA_GET_CURRENT_USER	无
并行请求	ASANA_SUBMIT_PARALLEL_REQUESTS	actions

由 Composio 提供支持