Usage Instructions
Integrate Asana into the workflow. Can read, write, and update tasks.
Tools
asana_get_task
Retrieve a single task by GID or get multiple tasks with filters
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
taskGid | string | No | The globally unique identifier (GID) of the task. If not provided, will get multiple tasks. |
workspace | string | No | Workspace GID to filter tasks (required when not using taskGid) |
project | string | No | Project GID to filter tasks |
limit | number | No | Maximum number of tasks to return (default: 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Operation success status |
output | object | Single task details or array of tasks, depending on whether taskGid was provided |
asana_create_task
Create a new task in Asana
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace | string | Yes | Workspace GID where the task will be created |
name | string | Yes | Name of the task |
notes | string | No | Notes or description for the task |
assignee | string | No | User GID to assign the task to |
due_on | string | No | Due date in YYYY-MM-DD format |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Operation success status |
output | object | Created task details with timestamp, gid, name, notes, and permalink |
asana_update_task
Update an existing task in Asana
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
taskGid | string | Yes | The globally unique identifier (GID) of the task to update |
name | string | No | Updated name for the task |
notes | string | No | Updated notes or description for the task |
assignee | string | No | Updated assignee user GID |
completed | boolean | No | Mark task as completed or not completed |
due_on | string | No | Updated due date in YYYY-MM-DD format |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Operation success status |
output | object | Updated task details with timestamp, gid, name, notes, and modified timestamp |
asana_get_projects
Retrieve all projects from an Asana workspace
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace | string | Yes | Workspace GID to retrieve projects from |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Operation success status |
output | object | List of projects with their gid, name, and resource type |
asana_search_tasks
Search for tasks in an Asana workspace
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace | string | Yes | Workspace GID to search tasks in |
text | string | No | Text to search for in task names |
assignee | string | No | Filter tasks by assignee user GID |
projects | array | No | Array of project GIDs to filter tasks by |
completed | boolean | No | Filter by completion status |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Operation success status |
output | object | List of tasks matching the search criteria |
asana_add_comment
Add a comment (story) to an Asana task
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
taskGid | string | Yes | The globally unique identifier (GID) of the task |
text | string | Yes | The text content of the comment |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Operation success status |
output | object | Comment details including gid, text, created timestamp, and author |
Notes
- Category:
tools - Type:
asana