Create and update Asana tasks from Guild agents

Integrations · Asana

Guild agents create, update, and search Asana tasks, and read projects, sections, portfolios, goals, and teams through the Asana REST API. Guild stores your Asana token and injects it server-side, so agent code never sees it. Credential policies decide which Asana operations each agent may call.

Book a demo

See how teams govern agents that use Asana.

Talk to sales

Get access to Guild, then connect Asana to your first agent.

What the Asana integration exposes

The integration is guildai~asana-openapi. It is generated from Asana’s OpenAPI description, which is what the -openapi suffix means: agents call the Asana REST API at https://app.asana.com/api/1.0, not Asana’s MCP server. Tools cover tasks, subtasks, dependencies, stories and comments, projects, sections, tags, custom fields, portfolios, goals, status updates, teams, users, and workspaces.

How it works

Create an Asana token

In Asana, open the developer console, click Create new token, and copy it. The token acts as you, so the agent sees what you can see.

Connect the token in Guild

Go to Access & setup > Credentials, click Connect, select asana-openapi, and paste the token into API Key.

Import the tools you need

Import AsanaOpenapiTools from @guildai-services/guildai~asana-openapi and use pick() to give the agent only the tools its job needs.

Why Asana access needs governing

A personal access token carries your full Asana permissions, including deleting tasks, projects, and sections. Guild keeps the token server-side and checks every request against your credential policies before it reaches Asana. A policy can allow an agent to read and comment on tasks while denying deletes, and you can scope a credential to one workspace or one agent.

Authentication

Type: API key
Header: Guild sends the token as Authorization: Bearer <token>
Token: an Asana personal access token. It doesn’t expire, but you can revoke it in the developer console.

See Credentials for workspace, member, and agent-scoped credentials.

Usage

import { AsanaOpenapiTools } from "@guildai-services/guildai~asana-openapi"
import { llmAgent, pick } from "@guildai/agents-sdk"

export default llmAgent({
  systemPrompt: "You triage new Asana tasks and comment with next steps.",
  tools: {
    ...pick(AsanaOpenapiTools, [
      "asana_openapi_search_tasks_for_workspace",
      "asana_openapi_get_task",
      "asana_openapi_update_task",
      "asana_openapi_create_story_for_task",
    ]),
  },
})

Tools are named with the asana_openapi_ prefix. The integration has more than 160 tools, so pick the ones the agent needs rather than spreading the whole set.

Tools

Tools in the latest published version of guildai~asana-openapi:

All 167 tools

Tool	What it does
`asana_openapi_add_custom_field_setting_for_portfolio`	Custom fields are associated with portfolios by way of custom field settings.
`asana_openapi_add_custom_field_setting_for_project`	Custom fields are associated with projects by way of custom field settings.
`asana_openapi_add_dependencies_for_task`	Marks a set of tasks as dependencies of this task, if they are not already dependencies. A task can have at most 30 dependents and dependencies combined.
`asana_openapi_add_dependents_for_task`	Marks a set of tasks as dependents of this task, if they are not already dependents. A task can have at most 30 dependents and dependencies combined.
`asana_openapi_add_followers`	Adds followers to a goal.
`asana_openapi_add_followers_for_project`	Adds the specified list of users as followers to the project.
`asana_openapi_add_followers_for_task`	Adds followers to a task.
`asana_openapi_add_item_for_portfolio`	Add an item to a portfolio.
`asana_openapi_add_members_for_portfolio`	Adds the specified list of users as members of the portfolio.
`asana_openapi_add_members_for_project`	Adds the specified list of users as members of the project.
`asana_openapi_add_project_for_task`	Adds the task to the specified project, in the optional location specified.
`asana_openapi_add_supporting_relationship`	Creates a goal relationship by adding a supporting resource to a given goal.
`asana_openapi_add_tag_for_task`	Adds a tag to a task.
`asana_openapi_add_task_for_section`	Add a task to a specific, existing section.
`asana_openapi_add_user_for_team`	The user making this call must be a member of the team in order to add others.
`asana_openapi_add_user_for_workspace`	Add a user to a workspace or organization.
`asana_openapi_create_attachment_for_object`	Upload an attachment.
`asana_openapi_create_batch_request`	Make multiple requests in parallel to Asana’s API.
`asana_openapi_create_custom_field`	Creates a new custom field in a workspace.
`asana_openapi_create_enum_option_for_custom_field`	Creates an enum option and adds it to this custom field’s list of enum options.
`asana_openapi_create_goal`	Creates a new goal in a workspace or team.
`asana_openapi_create_goal_metric`	Creates and adds a goal metric to a specified goal.
`asana_openapi_create_organization_export`	This method creates a request to export an Organization.
`asana_openapi_create_portfolio`	Creates a new portfolio in the given workspace with the supplied name.
`asana_openapi_create_project`	Create a new project in a workspace or team.
`asana_openapi_create_project_brief`	Creates a new project brief.
`asana_openapi_create_project_for_team`	Creates a project shared with the given team.
`asana_openapi_create_project_for_workspace`	Returns the compact project records for all projects in the workspace.
`asana_openapi_create_project_status_for_project`	Deprecated: new integrations should prefer the `/status_updates` route.
`asana_openapi_create_section_for_project`	Creates a new section in a project.
`asana_openapi_create_status_for_object`	Creates a new status update on an object.
`asana_openapi_create_story_for_task`	Adds a story to a task.
`asana_openapi_create_subtask_for_task`	Creates a new subtask and adds it to the parent task.
`asana_openapi_create_tag`	Creates a new tag in a workspace or organization.
`asana_openapi_create_tag_for_workspace`	Creates a new tag in a workspace or organization.
`asana_openapi_create_task`	Creating a new task is as easy as POSTing to the `/tasks` endpoint with a data block containing the fields you’d like to set on the task.
`asana_openapi_create_team`	Creates a team within the current workspace.
`asana_openapi_create_webhook`	Establishing a webhook is a two-part process.
`asana_openapi_delete_attachment`	Deletes a specific, existing attachment.
`asana_openapi_delete_custom_field`	A specific, existing custom field can be deleted by making a DELETE request on the URL for that custom field.
`asana_openapi_delete_goal`	A specific, existing goal can be deleted by making a DELETE request on the URL for that goal.
`asana_openapi_delete_portfolio`	An existing portfolio can be deleted by making a DELETE request on the URL for that portfolio.
`asana_openapi_delete_project`	A specific, existing project can be deleted by making a DELETE request on the URL for that project.
`asana_openapi_delete_project_brief`	Deletes a specific, existing project brief.
`asana_openapi_delete_project_status`	Deprecated: new integrations should prefer the `/status_updates/{status_gid}` route.
`asana_openapi_delete_section`	A specific, existing section can be deleted by making a DELETE request on the URL for that section.
`asana_openapi_delete_status`	Deletes a specific, existing status update.
`asana_openapi_delete_story`	Deletes a story.
`asana_openapi_delete_tag`	A specific, existing tag can be deleted by making a DELETE request on the URL for that tag.
`asana_openapi_delete_task`	A specific, existing task can be deleted by making a DELETE request on the URL for that task.
`asana_openapi_delete_webhook`	This method permanently removes a webhook.
`asana_openapi_duplicate_project`	Creates and returns a job that will asynchronously handle the duplication.
`asana_openapi_duplicate_task`	Creates and returns a job that will asynchronously handle the duplication.
`asana_openapi_get_attachment`	Get the full record for a single attachment.
`asana_openapi_get_attachments_for_object`	Returns the compact records for all attachments on the object.
`asana_openapi_get_audit_log_events`	Retrieve the audit log events that have been captured in your domain.
`asana_openapi_get_custom_field`	Get the complete definition of a custom field’s metadata.
`asana_openapi_get_custom_field_settings_for_portfolio`	Returns a list of all of the custom fields settings on a portfolio, in compact form.
`asana_openapi_get_custom_field_settings_for_project`	Returns a list of all of the custom fields settings on a project, in compact form.
`asana_openapi_get_custom_fields_for_workspace`	Returns a list of the compact representation of all of the custom fields in a workspace.
`asana_openapi_get_dependencies_for_task`	Returns the compact representations of all of the dependencies of a task.
`asana_openapi_get_dependents_for_task`	Returns the compact representations of all of the dependents of a task.
`asana_openapi_get_events`	Returns the full record for all events that have occurred since the sync token was created.
`asana_openapi_get_favorites_for_user`	Returns all of a user’s favorites in the given workspace, of the given type.
`asana_openapi_get_goal`	Returns the complete goal record for a single goal.
`asana_openapi_get_goal_relationship`	Returns the complete updated goal relationship record for a single goal relationship.
`asana_openapi_get_goal_relationships`	Returns compact goal relationship records.
`asana_openapi_get_goals`	Returns compact goal records.
`asana_openapi_get_items_for_portfolio`	Get a list of the items in compact form in a portfolio.
`asana_openapi_get_job`	Returns the full record for a job.
`asana_openapi_get_organization_export`	Returns details of a previously-requested Organization export.
`asana_openapi_get_parent_goals_for_goal`	Returns a compact representation of all of the parent goals of a goal.
`asana_openapi_get_portfolio`	Returns the complete portfolio record for a single portfolio.
`asana_openapi_get_portfolio_membership`	Returns the complete portfolio record for a single portfolio membership.
`asana_openapi_get_portfolio_memberships`	Returns a list of portfolio memberships in compact representation.
`asana_openapi_get_portfolio_memberships_for_portfolio`	Returns the compact portfolio membership records for the portfolio.
`asana_openapi_get_portfolios`	Returns a list of the portfolios in compact representation that are owned by the current API user.
`asana_openapi_get_project`	Returns the complete project record for a single project.
`asana_openapi_get_project_brief`	Get the full record for a project brief.
`asana_openapi_get_project_membership`	Returns the complete project record for a single project membership.
`asana_openapi_get_project_memberships_for_project`	Returns the compact project membership records for the project.
`asana_openapi_get_projects`	Returns the compact project records for some filtered set of projects.
`asana_openapi_get_projects_for_task`	Returns a compact representation of all of the projects the task is in.
`asana_openapi_get_projects_for_team`	Returns the compact project records for all projects in the team.
`asana_openapi_get_projects_for_workspace`	Returns the compact project records for all projects in the workspace. *Note: This endpoint may timeout for large domains.
`asana_openapi_get_project_status`	Deprecated: new integrations should prefer the `/status_updates/{status_gid}` route.
`asana_openapi_get_project_statuses_for_project`	Deprecated: new integrations should prefer the `/status_updates` route.
`asana_openapi_get_project_template`	Returns the complete project template record for a single project template.
`asana_openapi_get_project_templates`	Returns the compact project template records for all project templates in the given team or workspace.
`asana_openapi_get_project_templates_for_team`	Returns the compact project template records for all project templates in the team.
`asana_openapi_get_section`	Returns the complete record for a single section.
`asana_openapi_get_sections_for_project`	Returns the compact records for all sections in the specified project.
`asana_openapi_get_status`	Returns the complete record for a single status update.
`asana_openapi_get_statuses_for_object`	Returns the compact status update records for all updates on the object.
`asana_openapi_get_stories_for_task`	Returns the compact records for all stories on the task.
`asana_openapi_get_story`	Returns the full record for a single story.
`asana_openapi_get_subtasks_for_task`	Returns a compact representation of all of the subtasks of a task.
`asana_openapi_get_tag`	Returns the complete tag record for a single tag.
`asana_openapi_get_tags`	Returns the compact tag records for some filtered set of tags.
`asana_openapi_get_tags_for_task`	Get a compact representation of all of the tags the task has.
`asana_openapi_get_tags_for_workspace`	Returns the compact tag records for some filtered set of tags.
`asana_openapi_get_task`	Returns the complete task record for a single task.
`asana_openapi_get_task_counts_for_project`	Get an object that holds task count fields.
`asana_openapi_get_tasks`	Returns the compact task records for some filtered set of tasks.
`asana_openapi_get_tasks_for_project`	Returns the compact task records for all tasks within the given project, ordered by their priority within the project.
`asana_openapi_get_tasks_for_section`	Board view only: Returns the compact section records for all tasks within the given section.
`asana_openapi_get_tasks_for_tag`	Returns the compact task records for all tasks with the given tag.
`asana_openapi_get_tasks_for_user_task_list`	Returns the compact list of tasks in a user’s My Tasks list. *Note: Access control is enforced for this endpoint as with all Asana API endpoints, meaning a user’s private tasks will be filtered out…
`asana_openapi_get_team`	Returns the full record for a single team.
`asana_openapi_get_team_membership`	Returns the complete team membership record for a single team membership.
`asana_openapi_get_team_memberships`	Returns compact team membership records.
`asana_openapi_get_team_memberships_for_team`	Returns the compact team memberships for the team.
`asana_openapi_get_team_memberships_for_user`	Returns the compact team membership records for the user.
`asana_openapi_get_teams_for_user`	Returns the compact records for all teams to which the given user is assigned.
`asana_openapi_get_teams_for_workspace`	Returns the compact records for all teams in the workspace visible to the authorized user.
`asana_openapi_get_time_period`	Returns the full record for a single time period.
`asana_openapi_get_time_periods`	Returns compact time period records.
`asana_openapi_get_user`	Returns the full user record for the single user with the provided ID.
`asana_openapi_get_users`	Returns the user records for all users in all workspaces and organizations accessible to the authenticated user.
`asana_openapi_get_users_for_team`	Returns the compact records for all users that are members of the team.
`asana_openapi_get_users_for_workspace`	Returns the compact records for all users in the specified workspace or organization.
`asana_openapi_get_user_task_list`	Returns the full record for a user task list.
`asana_openapi_get_user_task_list_for_user`	Returns the full record for a user’s task list.
`asana_openapi_get_webhook`	Returns the full record for the given webhook.
`asana_openapi_get_webhooks`	Get the compact representation of all webhooks your app has registered for the authenticated user in the given workspace.
`asana_openapi_get_workspace`	Returns the full workspace record for a single workspace.
`asana_openapi_get_workspace_membership`	Returns the complete workspace record for a single workspace membership.
`asana_openapi_get_workspace_memberships_for_user`	Returns the compact workspace membership records for the user.
`asana_openapi_get_workspace_memberships_for_workspace`	Returns the compact workspace membership records for the workspace.
`asana_openapi_get_workspaces`	Returns the compact records for all workspaces visible to the authorized user.
`asana_openapi_insert_enum_option_for_custom_field`	Moves a particular enum option to be either before or after another specified enum option in the custom field.
`asana_openapi_insert_section_for_project`	Move sections relative to each other.
`asana_openapi_instantiate_project`	Creates and returns a job that will asynchronously handle the project instantiation.
`asana_openapi_project_save_as_template`	Creates and returns a job that will asynchronously handle the project template creation.
`asana_openapi_remove_custom_field_setting_for_portfolio`	Removes a custom field setting from a portfolio.
`asana_openapi_remove_custom_field_setting_for_project`	Removes a custom field setting from a project.
`asana_openapi_remove_dependencies_for_task`	Unlinks a set of dependencies from this task.
`asana_openapi_remove_dependents_for_task`	Unlinks a set of dependents from this task.
`asana_openapi_remove_follower_for_task`	Removes each of the specified followers from the task if they are following.
`asana_openapi_remove_followers`	Removes followers from a goal.
`asana_openapi_remove_followers_for_project`	Removes the specified list of users from following the project, this will not affect project membership status.
`asana_openapi_remove_item_for_portfolio`	Remove an item from a portfolio.
`asana_openapi_remove_members_for_portfolio`	Removes the specified list of users from members of the portfolio.
`asana_openapi_remove_members_for_project`	Removes the specified list of users from members of the project.
`asana_openapi_remove_project_for_task`	Removes the task from the specified project.
`asana_openapi_remove_supporting_relationship`	Removes a goal relationship for a given parent goal.
`asana_openapi_remove_tag_for_task`	Removes a tag from a task.
`asana_openapi_remove_user_for_team`	The user making this call must be a member of the team in order to remove themselves or others.
`asana_openapi_remove_user_for_workspace`	Remove a user from a workspace or organization.
`asana_openapi_search_tasks_for_workspace`	To mirror the functionality of the Asana web app’s advanced search feature, the Asana API has a task search endpoint that allows you to build complex filters to find and retrieve the exact data you…
`asana_openapi_set_parent_for_task`	parent, or no parent task at all.
`asana_openapi_typeahead_for_workspace`	Retrieves objects in the workspace based via an auto-completion/typeahead search algorithm.
`asana_openapi_update_custom_field`	A specific, existing custom field can be updated by making a PUT request on the URL for that custom field.
`asana_openapi_update_enum_option`	Updates an existing enum option.
`asana_openapi_update_goal`	An existing goal can be updated by making a PUT request on the URL for that goal.
`asana_openapi_update_goal_metric`	Updates a goal’s existing metric’s `current_number_value` if one exists, otherwise responds with a 400 status code.
`asana_openapi_update_goal_relationship`	An existing goal relationship can be updated by making a PUT request on the URL for that goal relationship.
`asana_openapi_update_portfolio`	An existing portfolio can be updated by making a PUT request on the URL for that portfolio.
`asana_openapi_update_project`	A specific, existing project can be updated by making a PUT request on the URL for that project.
`asana_openapi_update_project_brief`	An existing project brief can be updated by making a PUT request on the URL for that project brief.
`asana_openapi_update_section`	A specific, existing section can be updated by making a PUT request on the URL for that project.
`asana_openapi_update_story`	Updates the story and returns the full record for the updated story.
`asana_openapi_update_tag`	Updates the properties of a tag.
`asana_openapi_update_task`	A specific, existing task can be updated by making a PUT request on the.
`asana_openapi_update_team`	Updates a team within the current workspace.
`asana_openapi_update_webhook`	An existing webhook’s filters can be updated by making a PUT request on the URL for that webhook.
`asana_openapi_update_workspace`	A specific, existing workspace can be updated by making a PUT request on the URL for that workspace.

Frequently asked questions

Does the Asana integration use OAuth or the Asana MCP server?

No. It authenticates with a personal access token and calls the Asana REST API directly. The token acts as the person who created it.

Can an Asana change trigger a Guild agent?

Not yet. The integration includes Asana’s webhook management tools, but Guild doesn’t receive Asana events, so you can’t create an event trigger for Asana. Run the agent on a schedule instead.

Can I stop an agent from deleting Asana tasks?

Yes. Write a credential policy that denies the delete operations, such as asana_openapi_delete_task. A DENY rule always overrides an ALLOW rule. See Credential policies.

Also runs on Guild: Jira · Linear · Google Calendar Read: Docs: Credential policies · Credentials · Tools in agents

Overview

Models

Inference providers

Code & CI/CD

Communication

Project management

Testing

Design

Productivity

Monitoring & observability

Data

Web & search

Customer support

Sales & finance

Recruiting

Create and update Asana tasks from Guild agents

Book a demo

Talk to sales

What the Asana integration exposes

How it works

Why Asana access needs governing

Authentication

Usage

Tools

Frequently asked questions

Book a demo

Talk to sales

​What the Asana integration exposes

​How it works

​Why Asana access needs governing

​Authentication

​Usage

​Tools

​Frequently asked questions

​Related

What the Asana integration exposes

How it works

Why Asana access needs governing

Authentication

Usage

Tools

Frequently asked questions

Related