add_comment
Adds a comment to a task.
Adds a comment to a task. Supports plain text and HTML-formatted comments, @-mentions via GID references, and pinned comments. Use only for discussion, feedback, or context — not for actions Asana logs automatically (such as assignments or status changes).
create_project
Creates a new project immediately, without a confirmation step.
Creates a new project immediately, without a confirmation step. Optionally include sections and tasks in a single operation to set up the full project structure at creation time. Use create_project_preview in Claude or ChatGPT when you want to review the plan before creating.
create_project_preview
Drafts a structured project plan and presents it for review before creating it in Asana.
Drafts a structured project plan and presents it for review before creating it in Asana. Generates a project with sections, tasks, assignees, due dates, and priorities.
create_project_status_update
Posts a status update to a project or portfolio.
Posts a status update to a project or portfolio. Requires a title, a status color (green, yellow, red, blue, or complete), and body text. Supports plain text and HTML.
create_task_preview
Drafts a task and presents it for review before creating it in Asana.
Drafts a task and presents it for review before creating it in Asana. Use this when creating a single task and you want to confirm the details first. Fields in the preview: name, assignee, due date, start date, project, and section.
create_tasks
Creates one or more tasks immediately, without a confirmation step.
Creates one or more tasks immediately, without a confirmation step. Supports up to 50 tasks per call. Each task can specify a project, section, parent task (for subtasks), assignee, due date, start date, description, followers, and custom field values. Use create_task_preview in Claude or ChatGPT when you want to review before creating.
delete_task
Permanently deletes a task and any of its subtasks that are not also members of another project.
Permanently deletes a task and any of its subtasks that are not also members of another project. This action cannot be undone.
get_agent
Returns the full record for a single AI Teammate agent by GID.
Returns the full record for a single AI Teammate agent by GID. Includes name, description, behavior guidance, workspace, and photo. Use get_workspace_agents first to discover agent GIDs, then call this tool for full details on a specific agent.
get_attachments
Returns attachments for a task, project, or project brief.
Returns attachments for a task, project, or project brief. Includes file names, download URLs, and view URLs.
get_items_for_portfolio
Returns the items inside a portfolio, including projects and goals with their names and IDs.
get_me
Returns the name, email, and workspace memberships of the currently authenticated user.
Returns the name, email, and workspace memberships of the currently authenticated user. Use when you need specific details about the authenticated user rather than just their GID.
get_my_tasks
Returns tasks assigned to the currently authenticated user.
Returns tasks assigned to the currently authenticated user. A shortcut for common "what's on my plate" queries. Supports filtering by completion status.
get_portfolio
Returns full details for a single portfolio, including name, owner, and associated projects.
get_portfolios
Returns a list of portfolios owned by the authenticated user in the current workspace.
get_project
Returns full details for a single project: name, description, owner, member list, task counts, and optionally the project's sections.
get_projects
Returns a list of projects in the workspace.
Returns a list of projects in the workspace. Optionally filter by team or include archived projects.
get_status_overview
Returns an aggregated status report for one or more projects or portfolios based on keyword search.
Returns an aggregated status report for one or more projects or portfolios based on keyword search. Includes project details, current status updates, task summaries, and flagged blockers. This tool handles its own search internally — do not chain other search tools before calling it.
get_task
Returns full details for a single task: name, description, assignee, due dates, custom fields, project memberships, dependencies, subtasks, and comments.
get_tasks
Returns a filtered list of tasks by context.
Returns a filtered list of tasks by context. Requires at least one filter: project, section, tag, user task list, or assignee. Supports additional filters for completion status and modification date.
get_teams
Returns a list of teams in the workspace.
Returns a list of teams in the workspace. Optionally filter to only teams a specific user belongs to.
get_user
Returns details for a user by GID, email address, or the string "me".
Returns details for a user by GID, email address, or the string "me". Returns name, email, and workspace memberships. When called without a user identifier, returns the authenticated user.
get_users
Returns a list of users in the workspace.
Returns a list of users in the workspace. Optionally filter by team membership. Supports pagination for large workspaces.
get_workspace_agents
Returns a list of AI Teammate agents configured in the workspace.
Returns a list of AI Teammate agents configured in the workspace. Each record includes GID, name, resource type, and resource subtype. Use this to discover available AI Teammates before fetching full details with get_agent. Supports pagination. Note: this returns AI Teammates only — not human users. Use get_users for people.
search_objects
Universal search across Asana resource types.
Universal search across Asana resource types. Use this as the first step when you don't know the GID of an object. Supports tasks, projects, portfolios, goals, teams, users, tags, custom fields, and AI Teammates. V2 does not include a dedicated goals tool — use search_objects with resource_type: goal to find goals by name or partial match. Use resource_type: agent to search for AI Teammates specifically, or resource_type: actor to search for both humans and AI Teammates together — useful when finding anything that can be assigned work.
search_tasks
Advanced task search with full-text and complex filters.
Advanced task search with full-text and complex filters. Searches task names, descriptions, and comments. Supports filtering by assignee, due date, creation date, project, section, tag, and custom fields. Available on Premium accounts only; use get_tasks for non-Premium workspaces.
search_tasks_preview
Searches for tasks and displays results in an interactive UI.
Searches for tasks and displays results in an interactive UI. Supports filtering by assignee, due date range, start date, completion status, and text search.
update_tasks
Updates one or more tasks in a single operation.
Updates one or more tasks in a single operation. Supports up to 50 tasks per call. Fields that can be updated include name, assignee, due date, start date, description, completion status, parent, dependencies, dependents, project membership, followers, and custom fields.