Usage Instructions

Integrate Asana into the workflow. Can read, write, and update tasks.

Tools

Retrieve a single task by GID or get multiple tasks with filters

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)

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Single task details or array of tasks, depending on whether taskGid was provided

Create a new task in Asana

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

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Created task details with timestamp, gid, name, notes, and permalink

Update an existing task in Asana

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

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Updated task details with timestamp, gid, name, notes, and modified timestamp

Retrieve all projects from an Asana workspace

Parameter	Type	Required	Description
`workspace`	string	Yes	Workspace GID to retrieve projects from

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	List of projects with their gid, name, and resource type

Search for tasks in an Asana workspace

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

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	List of tasks matching the search criteria

Add a comment (story) to an Asana task

Parameter	Type	Required	Description
`taskGid`	string	Yes	The globally unique identifier (GID) of the task
`text`	string	Yes	The text content of the comment

Parameter	Type	Description
`success`	boolean	Operation success status
`output`	object	Comment details including gid, text, created timestamp, and author