Skip to main content

Asana

Comprehensive Asana connector for managing tasks, projects, users, teams, workspaces, custom fields, and attachments.

What you can ask​

  • Show me every Asana task assigned to me that's overdue, grouped by project.
  • Create a follow-up task in the Customer Onboarding project for every new account we closed yesterday.
  • Move all tasks in the Q2 Roadmap project that are still in Backlog after 30 days into Won't do.

Set up​

Asana needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Asana. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Asana developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Asana login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (18)

Grant the scopes for the tools you plan to allow.

  • attachments:delete
  • attachments:read
  • custom_fields:read
  • custom_fields:write
  • projects:delete
  • projects:read
  • projects:write
  • stories:read
  • stories:write
  • tags:read
  • tags:write
  • tasks:delete
  • tasks:read
  • tasks:write
  • teams:read
  • users:read
  • workspaces:read
  • workspaces:write

Tools​

Asana offers 56 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (28)​

View and search information without changing it.

ToolWhat it does
get_attachmentGet attachment details by GID including download URLs and metadata
get_current_userGet current authenticated user details including name, email, and workspaces
get_custom_fieldGet custom field details by GID including type, options, and settings
get_custom_fields_from_projectList all custom fields configured on a project with pagination support
get_projectGet complete project details by GID including name, team, members, dates, and settings
get_project_tasksGet all tasks in a project with optional field selection and pagination
get_storyGet story or comment details by GID including text and author
get_tagGet a single tag by GID including name, color, notes, and workspace.
get_taskGet complete task details by GID including name, assignee, dates, status, followers, tags, and custom fields
get_task_dependenciesGet tasks that must complete before this task.
get_task_storiesGet all comments and activity for task including assignments and status changes
get_task_subtasksGet all subtasks of a parent task with optional field selection
get_task_tagsGet all tags for a task including names and colors
get_teamGet team details by GID including name and organization
get_team_membersGet all members of a team with user details.
get_userGet user details by GID including name, email, and workspaces
get_user_task_listGet a user's My Tasks list for one workspace and return its GID.
get_workspaceGet workspace details by GID including name and organization status
list_attachmentsList attachments for task or project with pagination
list_custom_fieldsList custom fields in workspace with pagination
list_projectsList projects with workspace, team, or archive filtering.
list_tagsList tags in workspace with optional field selection and pagination
list_tasksList tasks filtered by project, tag, section, user_task_list, or assignee+workspace.
list_teamsList teams in workspace with optional field selection
list_usersList users in workspace with optional team filtering and field selection
list_workspacesList all workspaces accessible to the authenticated user
search_tasksAdvanced task search with text, assignee, project, date, and custom field filters.
validate_credentialValidate Asana credentials.

Write (11)​

Create or send data.

ToolWhat it does
add_custom_field_to_projectAssociate custom field with project for task metadata.
add_project_membersAdd members to project for collaboration and access.
add_task_dependenciesAdd dependencies to a task and return the task's resulting dependency list.
add_task_followersAdd followers to task for notifications about task updates and changes.
add_task_tagAdd tag to task for categorization and filtering.
create_commentAdd a plain-text or HTML comment to a task, optionally pinned.
create_custom_fieldCreate workspace custom field with type: text, number, date, enum, multi-enum, or people.
create_projectCreate project in workspace with team, privacy, view, dates, and members.
create_tagCreate tag in workspace with name, color, and notes.
create_taskCreate task in workspace, project, or as subtask with name, assignee, dates, followers, tags, and custom fields.
create_task_subtaskCreate subtask under parent task with name, assignee, dates, and other properties.

Delete or overwrite (17)​

Remove or replace existing data.

ToolWhat it does
delete_attachmentPermanently delete an attachment.
delete_custom_fieldPermanently delete a custom field.
delete_projectPermanently delete a project.
delete_storyDelete story or comment.
delete_tagPermanently delete a tag.
delete_taskPermanently delete a task.
remove_custom_field_from_projectRemove custom field from project to clean up metadata.
remove_project_membersRemove members from project to revoke access.
remove_task_dependenciesRemove dependency relationships from a task and return its remaining dependency list.
remove_task_followersRemove followers from task to stop notifications about updates.
remove_task_tagRemove tag from task to change categorization.
update_custom_fieldUpdate a custom field's name, description, or number precision.
update_projectUpdate project properties including name, notes, color, privacy, dates, and owner.
update_storyEdit story or comment text and pinned status.
update_tagUpdate a tag's name, color, or notes.
update_taskUpdate task properties including name, assignee, dates, status, and custom fields.
update_workspaceUpdate workspace name.
⌘J