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 Onboardingproject for every new account we closed yesterday. - Move all tasks in the
Q2 Roadmapproject that are still inBacklogafter 30 days intoWon't do.
Set up
Asana needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Asana. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Asana developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- 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:deleteattachments:readcustom_fields:readcustom_fields:writeprojects:deleteprojects:readprojects:writestories:readstories:writetags:readtags:writetasks:deletetasks:readtasks:writeteams:readusers:readworkspaces:readworkspaces: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.
| Tool | What it does |
|---|---|
get_attachment | Get attachment details by GID including download URLs and metadata |
get_current_user | Get current authenticated user details including name, email, and workspaces |
get_custom_field | Get custom field details by GID including type, options, and settings |
get_custom_fields_from_project | List all custom fields configured on a project with pagination support |
get_project | Get complete project details by GID including name, team, members, dates, and settings |
get_project_tasks | Get all tasks in a project with optional field selection and pagination |
get_story | Get story or comment details by GID including text and author |
get_tag | Get a single tag by GID including name, color, notes, and workspace. |
get_task | Get complete task details by GID including name, assignee, dates, status, followers, tags, and custom fields |
get_task_dependencies | Get tasks that must complete before this task. |
get_task_stories | Get all comments and activity for task including assignments and status changes |
get_task_subtasks | Get all subtasks of a parent task with optional field selection |
get_task_tags | Get all tags for a task including names and colors |
get_team | Get team details by GID including name and organization |
get_team_members | Get all members of a team with user details. |
get_user | Get user details by GID including name, email, and workspaces |
get_user_task_list | Get a user's My Tasks list for one workspace and return its GID. |
get_workspace | Get workspace details by GID including name and organization status |
list_attachments | List attachments for task or project with pagination |
list_custom_fields | List custom fields in workspace with pagination |
list_projects | List projects with workspace, team, or archive filtering. |
list_tags | List tags in workspace with optional field selection and pagination |
list_tasks | List tasks filtered by project, tag, section, user_task_list, or assignee+workspace. |
list_teams | List teams in workspace with optional field selection |
list_users | List users in workspace with optional team filtering and field selection |
list_workspaces | List all workspaces accessible to the authenticated user |
search_tasks | Advanced task search with text, assignee, project, date, and custom field filters. |
validate_credential | Validate Asana credentials. |
Write (11)
Create or send data.
| Tool | What it does |
|---|---|
add_custom_field_to_project | Associate custom field with project for task metadata. |
add_project_members | Add members to project for collaboration and access. |
add_task_dependencies | Add dependencies to a task and return the task's resulting dependency list. |
add_task_followers | Add followers to task for notifications about task updates and changes. |
add_task_tag | Add tag to task for categorization and filtering. |
create_comment | Add a plain-text or HTML comment to a task, optionally pinned. |
create_custom_field | Create workspace custom field with type: text, number, date, enum, multi-enum, or people. |
create_project | Create project in workspace with team, privacy, view, dates, and members. |
create_tag | Create tag in workspace with name, color, and notes. |
create_task | Create task in workspace, project, or as subtask with name, assignee, dates, followers, tags, and custom fields. |
create_task_subtask | Create subtask under parent task with name, assignee, dates, and other properties. |
Delete or overwrite (17)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_attachment | Permanently delete an attachment. |
delete_custom_field | Permanently delete a custom field. |
delete_project | Permanently delete a project. |
delete_story | Delete story or comment. |
delete_tag | Permanently delete a tag. |
delete_task | Permanently delete a task. |
remove_custom_field_from_project | Remove custom field from project to clean up metadata. |
remove_project_members | Remove members from project to revoke access. |
remove_task_dependencies | Remove dependency relationships from a task and return its remaining dependency list. |
remove_task_followers | Remove followers from task to stop notifications about updates. |
remove_task_tag | Remove tag from task to change categorization. |
update_custom_field | Update a custom field's name, description, or number precision. |
update_project | Update project properties including name, notes, color, privacy, dates, and owner. |
update_story | Edit story or comment text and pinned status. |
update_tag | Update a tag's name, color, or notes. |
update_task | Update task properties including name, assignee, dates, status, and custom fields. |
update_workspace | Update workspace name. |