> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Asana **Authentication:** OAuth or personal access token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app. ## Sample use cases * 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`. ## Available Tools #### get\_attachment Get attachment details by GID including download URLs and metadata #### delete\_attachment Permanently delete an attachment. This action is irreversible #### list\_attachments List attachments for task or project with pagination #### create\_custom\_field Create workspace custom field with type: text, number, date, enum, multi-enum, or people #### get\_custom\_field Get custom field details by GID including type, options, and settings #### update\_custom\_field Update custom field name, description, or enum options #### delete\_custom\_field Permanently delete a custom field. This action is irreversible #### list\_custom\_fields List custom fields in workspace with pagination #### create\_project Create project in workspace with team, privacy, view, dates, and members #### get\_project Get complete project details by GID including name, team, members, dates, and settings #### update\_project Update project properties including name, notes, color, privacy, dates, and owner #### delete\_project Permanently delete a project. This action is irreversible #### list\_projects List projects with workspace, team, or archive filtering. Supports pagination #### get\_project\_tasks Get all tasks in a project with optional field selection and pagination #### add\_project\_members Add members to project for collaboration and access #### remove\_project\_members Remove members from project to revoke access #### add\_custom\_field\_to\_project Associate custom field with project for task metadata #### remove\_custom\_field\_from\_project Remove custom field from project to clean up metadata #### get\_custom\_fields\_from\_project List all custom fields configured on a project with pagination support #### search\_tasks Advanced task search with text, assignee, project, date, and custom field filters. Requires Premium #### get\_task\_stories Get all comments and activity for task including assignments and status changes #### get\_story Get story or comment details by GID including text and author #### update\_story Edit story or comment text and pinned status. Can only edit own stories #### delete\_story Delete story or comment. Can only delete own stories. Action is irreversible #### create\_comment Add comment to task with text and optional pinning #### list\_tags List tags in workspace with optional field selection and pagination #### get\_task\_tags Get all tags for a task including names and colors #### 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 #### get\_task Get complete task details by GID including name, assignee, dates, status, followers, tags, and custom fields #### update\_task Update task properties including name, assignee, dates, status, and custom fields #### delete\_task Permanently delete a task. This action is irreversible #### list\_tasks List tasks filtered by project, tag, section, or assignee. Supports date filters and pagination #### add\_task\_followers Add followers to task for notifications about task updates and changes #### remove\_task\_followers Remove followers from task to stop notifications about updates #### get\_task\_subtasks Get all subtasks of a parent task with optional field selection #### create\_task\_subtask Create subtask under parent task with name, assignee, dates, and other properties #### add\_task\_tag Add tag to task for categorization and filtering #### remove\_task\_tag Remove tag from task to change categorization #### get\_task\_dependencies Get tasks that must complete before this task. Returns up to 30 dependencies #### add\_task\_dependencies Add dependencies to task. Maximum 30 total dependencies and dependents combined per task #### remove\_task\_dependencies Remove dependency relationships from task to change workflow order #### list\_teams List teams in workspace with optional field selection #### get\_team Get team details by GID including name and organization #### get\_team\_members Get all members of a team with user details #### list\_users List users in workspace with optional team filtering and field selection #### get\_user Get user details by GID including name, email, and workspaces #### get\_current\_user Get current authenticated user details including name, email, and workspaces #### list\_workspaces List all workspaces accessible to the authenticated user #### get\_workspace Get workspace details by GID including name and organization status #### update\_workspace Update workspace name