List all Asana workspaces accessible to the current token. Call this first to get the workspace GID required by most other tools. Most accounts have exactly one workspace. Returns an array with gid, resource_type, and name by default.

Get details for an Asana user by GID, email address, or 'me' (current user). Returns gid, name, and email by default. Use 'me' to identify the current token's user. Use asana_get_users_for_workspace to find GIDs by name or email.

List all users in a workspace. Returns gid, name, and email for each user. Use this to find a user's GID before assigning tasks or filtering by assignee. Supports pagination for large workspaces.

Get details for a team by GID. Returns gid, name, description, and organization. Use asana_get_teams_for_workspace to find team GIDs.

List all teams in a workspace. Returns gid and name for each team. Use this to find a team GID before calling asana_create_project — most organization workspaces require a team. Supports pagination.

Search for Asana objects (tasks, projects, users, tags, teams, portfolios, goals) by partial name. Returns up to 100 compact results with gid and name. Use this to find the GID of a resource when you only know its name — e.g. find a task called 'Fix login bug' before updating it. Results are ordered by relevance (recency for projects, contact frequency for users). For users, include opt_fields: 'gid,name,email' to get email addresses.

Search for projects in a workspace by name using a regex pattern. Fetches all projects (auto-paginated) and filters client-side. Use name_pattern: '.' to list all projects. Returns array of objects with gid, name, resource_type by default.

Get full details for a project by GID. Returns gid, name, archived, color, created_at, modified_at, default_view, due_on, start_on, notes, privacy_setting, public, team.gid, and workspace.gid by default.

Get task counts for a project broken down by completion status. IMPORTANT: returns an empty object unless opt_fields specifies count fields explicitly. Always include opt_fields.

List all sections in a project. Returns array of objects with gid, name, resource_type. Section GIDs are needed to place tasks in specific sections or to call section-specific tools.

Create a new project in a workspace. In organization workspaces (most), a team GID is required. Returns the created project object.

Update fields on an existing project. Only supply the fields you want to change. Returns the updated project object.

Permanently delete a project and all its tasks. This action cannot be undone.

Get a single project status update by its GID. Returns the status object including text, color (green/yellow/red), title, author, and created_at.

List all status updates for a project, ordered newest first. Status updates are the periodic health check-ins (green/yellow/red) visible in the project's status tab. Returns an array of status objects.

Create a new status update for a project (the health check-in shown in the project's status tab). Returns the created status object. Use color to visually signal project health.

Permanently delete a project status update. This cannot be undone.

Full-text search for tasks across a workspace with advanced filters. Searches task names AND descriptions. Returns up to 100 results (no auto-pagination). Prefer filters like projects_any, assignee_any, completed, or due_on_before to narrow results. Returns minimal fields by default — always use opt_fields.

Get full details for a single task by GID. Default response is minimal (gid + name only) — always use opt_fields. Returns rich data including custom fields, memberships (project+section), HTML notes, parent, subtask count, tags, and followers.

Create a new task. Use memberships to place it directly in a specific project section (preferred over project_id alone). Returns the created task object.

Update fields on an existing task. Only supply the fields you want to change. Returns the updated task object. To mark complete: set completed: true. To move sections: use asana_add_task_to_section instead.

Create a subtask under an existing task. Subtasks are tasks with a parent. Returns the created subtask object. Use asana_get_subtasks to list existing subtasks.

Fetch up to 25 tasks by GID in a single call. More efficient than calling asana_get_task repeatedly. Use when you have a known list of task GIDs (e.g. from a search result). Returns the same fields as asana_get_task.

Add an existing task to a project (tasks can belong to multiple projects). Added to the end of the project by default. Optionally specify a section or relative position. Use at most one of: section, insert_after, insert_before.

Remove a task from a project. The task still exists and remains in any other projects it belongs to. Only removes the association.

Permanently delete a task including all its subtasks. This cannot be undone. Use asana_update_task with completed: true instead if you just want to mark it done.

List all direct subtasks of a task. Returns only one level deep — call recursively for nested subtasks. Returns minimal fields by default, use opt_fields for more.

List all tasks in a project (direct members only, not subtasks). Returns tasks across all sections. For tasks in a specific section use asana_get_tasks_for_section. Returns minimal fields by default — use opt_fields.

List all tasks in a specific project section. Use asana_get_project_sections to get section GIDs. Returns minimal fields by default — use opt_fields.

Mark one or more tasks as dependencies of a given task (i.e. the given task cannot start until the dependency tasks are complete). Returns an empty object {} on success. Use asana_get_task with opt_fields=dependencies to verify.

Mark one or more tasks as dependents of a given task (i.e. those tasks cannot start until this task is complete). Returns an empty object {} on success. This is the inverse of asana_add_task_dependencies.

Convert a task into a subtask by assigning it a parent task. Optionally control the subtask's position among its siblings. Returns the updated task object including the new parent. To remove a parent (promote a subtask to top-level), set parent to null.

Get all stories (comments and system activity) for a task, ordered oldest first. Returns an array of story objects — each has type: 'comment' (user-added comments) or type: 'system' (auto-generated activity like assignments and status changes). Filter for type === 'comment' to get only user comments.

Add a comment to a task. Provide either text (plain text) or html_text (formatted). If both are given, html_text is used and text is ignored. Returns the created story object including gid, text, created_at, created_by.

Get full details for a single tag by GID. Returns the tag's name, color, notes, followers, and workspace. Use asana_get_tags_for_workspace to find a tag GID by name.

List all tags currently applied to a task. Returns an array of tag objects with gid, name, and color. Tags are workspace-scoped labels used to categorize tasks across projects.

List all tags in a workspace. Tags are workspace-scoped and can be applied to any task. Returns an array of tag objects. Use limit and offset for pagination on large workspaces.

Update the name, color, or notes of an existing tag. Only supply the fields you want to change. Returns the updated tag object.

Permanently delete a tag from the workspace. This does NOT remove the tag from tasks — it just deletes the tag itself. Returns an empty object {} on success.

List all tasks that have a specific tag applied. Returns an array of task objects. Useful for finding all tasks in a workspace labeled with a particular tag, regardless of project.

Create a new tag in a workspace. Tags are workspace-scoped and can be applied to any task. Returns the created tag object. After creating, use asana_add_tag_to_task to apply it.

Apply a tag to a task. Returns an empty object {} on success. Use asana_get_tags_for_workspace to find the tag GID first. To remove the tag, use asana_remove_tag_from_task.

Remove a tag from a task (does not delete the tag itself). Returns an empty object {} on success.

Get details for a single section by GID. Returns the section's name, created_at, and parent project. Use asana_get_project_sections to list all sections in a project and find GIDs.

Create a new section in a project. Sections appear as column headers in board view or group headers in list view. Returns the created section object with gid and name. Use insert_before or insert_after to control placement.

Rename an existing section. Returns the updated section object with gid and name. To reorder sections, use asana_move_section instead.

Delete a section from a project. Tasks in the deleted section are moved to the project's default (first) section — they are NOT deleted. The last remaining section in a project cannot be deleted. Returns a success message.

Reorder a section within a project by moving it before or after another section. Returns an empty object {} on success. To rename a section, use asana_update_section.

Move a task into a specific section within a project. The task is placed at the top of the section unless insert_before or insert_after is specified. Returns a success message. Prefer using the memberships parameter in asana_create_task to place tasks in sections at creation time.

Get full details for a portfolio by GID. Returns name, color, public status, owner, members, and workspace. Use asana_get_portfolios to find portfolio GIDs.

List portfolios in a workspace. IMPORTANT: The owner parameter is required by the Asana API — omitting it returns a Bad Request error. Use owner: 'me' to list your own portfolios. Returns an array of portfolio objects.

Create a new portfolio in a workspace. Portfolios group related projects for high-level tracking. Returns the created portfolio object with gid and name.

Update the name, color, or public visibility of a portfolio. Only supply the fields to change. Returns the updated portfolio object.

Permanently delete a portfolio. This does NOT delete the projects in the portfolio. Returns a success message.

List all projects in a portfolio. Returns an array of project objects with gid, name, color, and archived status. Use asana_add_portfolio_item to add projects.

Add a project to a portfolio. Optionally control placement with insert_before or insert_after. Returns a success message.

Remove a project from a portfolio. This does NOT delete the project — it only removes the association. Returns a success message.

Get full details for a goal by GID. Returns name, status, notes, owner, team, time_period, followers, and workspace. Use asana_get_goals to list goals and find GIDs.

List goals in a workspace. Returns an array of goal objects with gid, name, status, owner, and team. Filter by team or time period using optional params. Supports pagination.

Create a new goal in a workspace. IMPORTANT: time_period is required by the Asana API — get valid GIDs from asana_get_time_periods. Returns the created goal object. Note: status can only be set after a goal metric is configured.

Update fields on an existing goal. Only supply the fields to change. Returns the updated goal object. Note: setting status requires the goal to have a metric configured first — otherwise the API returns an error.

Permanently delete a goal. This cannot be undone. Returns a success message.

List all time periods in a workspace (fiscal years, halves, and quarters). Time periods are used to scope goals. Returns a hierarchical array: FY (fiscal year) → H (half-year) → Q (quarter), each with gid, display_name, start_on, end_on, and parent. Use the GIDs with asana_create_goal or asana_get_goals.

Get full details for a single time period by GID. Returns display_name, start_on, end_on, and parent time period. Use asana_get_time_periods to find GIDs.

List all time tracking entries logged for a task. Returns an array of entry objects with gid, duration_minutes, entered_on, and created_by. Note: time tracking must be enabled in the workspace.

Log time spent on a task. Returns the created entry with gid, duration_minutes, entered_on, and created_by. Note: time tracking must be enabled in the workspace.

Get a single time tracking entry by GID. Returns gid, duration_minutes, entered_on, created_by, and task. Use asana_get_time_tracking_entries to find entry GIDs.

Update the duration or date of an existing time tracking entry. Returns the updated entry with gid, duration_minutes, and entered_on.

Permanently delete a time tracking entry from a task. This cannot be undone. Returns a success message.

List all attachments on a task or project. Returns gid, name, resource_subtype, created_at, and host for each attachment. Use asana_get_attachment to get the download URL for a specific file.

Get full details for a single attachment by GID. Returns name, download_url, view_url, size, host, created_at, and parent. Use the download_url to access the file. Use asana_get_attachments_for_object to list all attachments on a task.

Delete an attachment from a task or project. Returns an empty object {} on success. This action is permanent. Get attachment GIDs from asana_get_attachments_for_object.

Attach an external URL link to a task or project. Creates a named link that appears in the task's attachments panel. Use this to link GitHub PRs, documents, design files, or any external resource to a task. Note: file upload (binary) is not supported through this tool — only URL-based (external) attachments.

List all custom field definitions in a workspace. Returns gid, name, type, and enum_options for each field. Use this to discover available custom fields and their GIDs before reading or writing custom field values on tasks.

Get full details for a custom field by GID. Returns name, type, description, enum_options (with gid, name, color, enabled), precision, and format. Use this to get enum option GIDs before setting custom field values on tasks.

Create a new custom field in a workspace. Supported types: text, number, enum, multi_enum, date, people. For enum/multi_enum fields, add options after creation using asana_create_enum_option. Returns the created custom field object.

Update a custom field's name, description, or settings. Note: the type field cannot be changed after creation. To add/update enum options, use asana_create_enum_option or asana_update_enum_option. Returns the updated custom field.

Permanently delete a custom field from the workspace. This removes the field from all tasks and projects. Locked fields can only be deleted by the user who locked them. Returns an empty object {} on success.

Add a new option to an enum or multi_enum custom field. New options are appended to the end of the list by default. Returns the created enum option with its GID. Use the GID to set this option on tasks via asana_update_task.

Update an enum option's name, color, or enabled status. Use this to rename options, change their color, or disable/enable them. Disabled options are hidden from users but existing values are preserved. Returns the updated enum option.

Reconstruct a task's full lifecycle from its Asana activity stream. Returns the chronological event timeline (assignments, section moves, reschedules, completions, custom-field changes, comments), how long the task spent in each section, cycle/lead time, reschedule history with slip days, ownership churn, and triggered risk signals (stalled, chronic slip, ownership churn, review-bound). Use this to answer 'why is this task late?', 'where did it get stuck?' or 'who has touched it?'. Accepts a task GID, an Asana task URL, or a task name. Costs 2–3 API requests (more for very long activity streams).

Compute delivery-flow statistics for a project by replaying the activity stream of its recently-completed tasks. Returns cycle-time and lead-time percentiles (p50/p85/p95 — cycle time is right-skewed, so the mean is reported only as a secondary figure), per-section dwell times ranked worst-first to expose bottlenecks, weekly throughput, reschedule frequency and median slip, and 'worst offender' task lists with clickable permalinks. EXPENSIVE: costs roughly one API request per sampled task, so it is bounded by max_tasks (hard cap 100) and by the server-wide per-prompt request budget; the response always states how much of the project was actually sampled. Use this to answer 'where does work get stuck?' or 'how long does delivery actually take?'.

Summarize what a person did in Asana over a date range: tasks completed, tasks created, optional comment activity, and current open workload. Aggregates by month and by project. Uses windowed search to work correctly beyond Asana's 100-result search cap, and always reports coverage so partial results are never mistaken for complete ones. Returns methodology caveats that must be surfaced alongside any figures — notably that assignee reflects the CURRENT assignee, not who did the work.

Find completed tasks similar to a target task, to anchor an estimate on real history (reference-class forecasting). Returns each comparable's story points AND its actual cycle time, which is what reveals where past estimates were wrong. Similarity is computed from name/description term overlap, shared tags, and section match. Use this before estimating so the estimate is grounded in what work of this shape has actually cost.

Compute delivery velocity for a person or project over recent periods. Reports median and MAD (not mean and stddev — small samples make stddev unstable), detects bulk-close periods and excludes them, and reports what fraction of completed tasks actually had story points. When points coverage is below 50% the point velocity is SUPPRESSED and task-count velocity is returned instead, because low-coverage point velocity looks authoritative while measuring an arbitrary subset. Always returns a commitment RANGE, never a single number.

Resolve code references — branch names, commit subjects, PR titles — to the Asana tasks they refer to. Recognizes bare GIDs, Asana URLs, #1234 / ASANA-1234 conventions, and falls back to a conservative fuzzy name match that only accepts a single unambiguous hit. Use this to connect repository history to Asana work, e.g. to find which tasks have no code behind them or which commits have no tracked task.