Asana
Connects to the Asana REST API for managing workspaces, projects, and tasks. An agent can list workspaces and projects, and create, read, update, and search tasks.
Add to an agent node's tools array with _node_type: "tool-asana". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
access_token | Yes | Asana Personal Access Token (or OAuth access token), sent as Authorization: Bearer <token>. Can come from a stored secret or an oauth_connection_id. |
{
"name": "asana",
"_node_type": "tool-asana",
"access_token": "{{ secret.ASANA_ACCESS_TOKEN }}"
}
Tools
asana_list_workspaces
List all Asana workspaces. Use this to find workspace IDs.
No parameters.
Returns: A newline-separated list of - **<name>** gid: <gid> lines, or "No workspaces found.".
asana_list_projects
List projects in an Asana workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace_gid | string | Yes | Workspace GID (use asana_list_workspaces to find) |
limit | number | No | Max projects (default 20) |
Returns: A newline-separated list of - **<name>** gid: <gid> lines, or "No projects found.".
asana_list_tasks
List tasks in an Asana project.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_gid | string | Yes | Project GID to list tasks from |
limit | number | No | Max tasks (default 20) |
Returns: A newline-separated list of [ ]/[x] checkbox-prefixed lines with the task name, due date, and gid, or "No tasks found.".
asana_get_task
Get full details of an Asana task.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_gid | string | Yes | Asana task GID |
Returns: A formatted string with the task name, completed status, due date, and notes/description.
asana_create_task
Create a new task in an Asana project.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Task name |
project_gid | string | Yes | Project GID to add task to |
notes | string | No | Task description/notes |
due_on | string | No | Due date (YYYY-MM-DD) |
assignee_gid | string | No | Assignee GID or me |
Returns: A confirmation message with the new task's name and gid.
asana_update_task
Update an existing Asana task.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_gid | string | Yes | Task GID to update |
name | string | No | New task name |
notes | string | No | New notes |
due_on | string | No | New due date (YYYY-MM-DD) |
completed | boolean | No | Mark task as completed |
Returns: A confirmation message with the updated task's name.
asana_search_tasks
Search for tasks across an Asana workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace_gid | string | Yes | Workspace GID to search in |
text | string | Yes | Search text |
Returns: A newline-separated list of [ ]/[x] checkbox-prefixed lines with the task name and gid, or "No tasks found.".