Asana Tools

List all attachments for a project, project brief, or task. Returns attachment names, IDs, and URLs (download_url, permanent_url, view_url). Use for a...

List projects filtered by workspace. Supports team, archived filters. Returns project names and IDs. Use for filtered project views and bulk operation...

Get teams user belongs to. Returns team names and IDs. Use to check user team access or find teams for specific user. Requires organization ID. "me" s...

Get detailed information about a time period by ID. Returns name, start date, end date, and status. Use after finding time period ID from other tools....

List all team members. Returns user names and IDs. Use team ID from typeahead search first. Supports pagination for large teams. Results are sorted al...

Add followers to task (team members to notify of updates). Automatically sends notifications for task changes. Returns updated followers list. Essenti...

Get ALL projects in a workspace across all teams. Returns project names and IDs. Use for workspace-wide operations or when team is unknown. May return...

Remove followers from task (stop notification subscriptions). Prevents future notifications while maintaining history. Returns updated followers list....

List all status updates for a project chronologically. Returns status color, text, author for each update. Use to track project health over time. Supp...

Get single status update by ID. Returns color (green/yellow/red), text, author, and timestamp. Use when you know specific status ID. For all statuses,...

Delete task from Asana. Use with extreme caution as recovery is challenging. Deletes the task and any subtasks that are not also in another project. R...

Get detailed project data including name, description, owner, members, custom fields, and settings. Use after finding project ID via typeahead. Return...

List available time periods in a workspace. Filterable by date range. Returns time period names, IDs, start/end dates. REQUIRES workspace parameter. U...

Create a new goal. REQUIRES name, time_period, and either workspace or team. Use to establish objectives and key results. Returns created goal details...

Create project status update with color (green/yellow/red) and text. Use for regular project health updates, milestone documentation, or blocker repor...

Get detailed goal data including name, owner, current_status_update, and due_on. Use after finding goal ID via typeahead. Returns complete goal config...

Get full task details by ID. Returns name, description, assignee, due dates, custom fields, projects, dependencies. Essential before updating tasks. U...

Get detailed portfolio data by ID including name, owner, and projects. Use after finding portfolio ID via typeahead. Returns complete portfolio config...

List portfolios filtered by workspace and owner. REQUIRES workspace parameter. Owner defaults to "me" (current user) if not specified. Returns portfol...

Advanced task search with multiple filters. Supports text search, all date filters, status filters, user filters, project/portfolio/section/tag filter...

Create task in Asana with context. REQUIRES one of: project_id, parent, or workspace+assignee together. For assignee-only tasks, both workspace and as...

Get user details by ID, email, or "me". Returns name, email, workspaces. Use to find user IDs for task assignment. "me" returns authenticated user inf...

Quick search across Asana objects. ALWAYS use this FIRST before specialized search. Returns most relevant items based on recency and usage. Faster tha...

Update goal metric properties like current_number_value. Returns updated goal data. Partial updates supported - only specified fields will change.

List tasks filtered by context (workspace/project/tag/section/user list). One context required. Supports assignee, date filters. Returns task names an...

List all projects for a team. Returns both active and archived projects with IDs. Use after finding team ID via typeahead. Supports pagination for tea...

Get all users in workspace. Returns compact users with names and IDs. Results are sorted alphabetically and limited to 2000. Prefer searching more nar...

Set tasks blocked by this task (tasks waiting on this one). Creates dependency where other tasks cannot start until this completes. Use for blocking r...

List all teams in workspace. Returns team names and IDs. Use to discover teams before searching team projects/users. Essential for workspace structure...

List all parent goals for a specific goal. Returns parent goal names, IDs, and metric.progress. Use to understand goal hierarchy and relationships. Im...

Get task activity history (comments, status changes, system events). Returns chronological stories with authors and timestamps. Use for audit trails, ...

List projects, goals, and other items in a portfolio. Returns item names, IDs, and types. Use for portfolio content exploration and management. Suppor...

Update goal properties like name, owner, dates, metrics, or status. Use for adjusting timelines, progress, or reassigning ownership. Returns updated g...

Create new project in Asana. Every project requires a workspace, and this cannot be changed after creation. If workspace is an organization, a team mu...

Set tasks this task depends on (prerequisites). Creates dependency relationship where this task is blocked until dependencies complete. Use for workfl...

Change task parent (convert to/from subtask). Set parent=null to make regular task. Supports insert positioning among siblings. Use for reorganizing t...

List goals filtered by context (portfolio, project, task, workspace, or team). One context required. Returns goal names, IDs. Use for goal overview or...

Get detailed attachment data including name, resource type, download_url, view_url, and parent. Returns complete attachment information needed for acc...

List all sections in a project with their IDs. Essential for task placement and organization. Returns section names and IDs needed for creating/moving...

Update existing task properties. Change name, notes, assignee, completion status, due dates, custom fields. Requires task ID. Returns updated task dat...

Get all accessible workspaces. Returns workspace IDs needed for most other operations. Always call this FIRST to discover valid workspace IDs before u...

Add explicit comment to task. ONLY for discussion, feedback, questions, or context not captured by automatic activity logging. Task actions (assignmen...

Get task statistics for a project. Returns counts of incomplete, completed, and milestone tasks. Use for quick project progress overview, capacity che...