Add a task to a project, optionally placing it in a specific section. Fixes: no MCP tool for addProject + section placement.

Move a task to a different section within its project. Fixes: no MCP tool for section moves.

Set custom fields on a task using correct type handling. Fixes: multi_enum arrays and date object wrappers that fail via official MCP.

Set rich-text notes on a task using html_notes. Fixes: "XML is invalid" error from official MCP.

Set start_on and/or due_on dates on a task. Fixes: start_on not exposed in official MCP schema, and due_on must be set first.

Update multiple task fields in a single REST call. Combines assignee, dates, custom fields, notes, name, and completion.

Attach a local file to an Asana task. Requires confirm:true and restricts reads to the current directory or ASANA_MCP_FILE_ROOTS. Max 100MB.

Execute up to 5 Asana API operations in a single HTTP call. ⚠ GET-with-default-fields ONLY — options (opt_fields/completed_since) + PUT data are dropped by the batch endpoint. For filtered reads use asana_search_tasks/asana_list_*; for writes use the dedicated tools.

Fetch one task with rich fields (assignee, projects, section memberships, custom fields, notes, subtask count). Override opt_fields for more/less.

Advanced workspace task search with filters: text, assignee, project, section, tag, completed, due/created date ranges, custom-field filters (filters passthrough), sorting. Single page (search API caps at 100, no offset).

List tasks by project, section, tag, OR assignee (provide exactly one anchor). Paginated. assignee uses the workspace default.

List the TOKEN OWNER's My Tasks (user task list). NOTE: a personal PAT can only read its OWN My Tasks — passing another user returns 403. For other users use asana_search_tasks or asana_list_tasks with assignee=, or asana_user_queue. Paginated.

List projects in the workspace (or a team). Excludes archived by default; set include_archived=true for all. Paginated.

Fetch one project with its custom_field_settings (field GIDs + enum option GIDs) AND its sections, merged into one response.

List the sections of a project (name + GID), in board order.

List workspace members (name → GID resolution). Paginated.

Fetch one user by GID (default "me" = token owner). Returns name, email, GID.

List teams the token owner belongs to in the workspace/organization. Paginated.

List tags in the workspace (name → GID). Paginated.

List a task's stories (comments + activity log). text field holds comment bodies. Paginated.

List a task's subtasks with rich fields. Paginated.

Return a task's dependencies (what it waits on) AND dependents (what waits on it), in one call.

List a task's attachments with download/permanent URLs and sizes.

List a project's status updates (status_type, title, text, author). Paginated.

List portfolios owned by a user in the workspace. owner defaults to "me". Paginated.

Fetch one portfolio; set include_items=true to also pull its member projects/portfolios.

Create a general task. Provide either projects[] (workspace inferred) or it lands in the workspace default. Supports assignee, notes/html_notes, dates, followers, tags, custom_fields (dates auto-wrapped).

Add a comment (story) to a task. Prefer text (plain, with real newlines; literal "\n" sequences are auto-converted) — the /stories endpoint escapes html_text into literal tags. Pass html_text only if you accept that.

Create a subtask under a parent task.

Mark a task as depending on one or more other tasks (this task waits on them).

Mark one or more tasks as dependent on this task (they wait on this one).

Add a tag to a task.

Remove a tag from a task.

Add follower(s) to a task.

Remove follower(s) from a task.

Mark a task complete (default) or incomplete (completed:false).

Create a new section in a project. Optionally position via insert_before/insert_after (section GIDs).

Create a project. In an org workspace a team GID is required; otherwise the workspace default is used.

Post a status update to a project. status_type ∈ on_track|at_risk|off_track|on_hold|complete. text required (html_text optional).

Duplicate a task (template instantiation). include = which fields to copy (array or comma string, e.g. ["notes","assignee","subtasks","dependencies"]). Returns an async job.

DESTRUCTIVE — permanently delete (trash) a task. Requires confirm:true (C13 gate). Without confirm it is a no-op that reports the gate.

Apply the SAME field changes to MANY tasks in one call (assignee, dates, completed, notes/html_notes, custom_fields). Loops PUT per task, continues past individual failures, returns a per-task summary.

Move MANY tasks into one section in a single call (loops section addTask). Returns a per-task summary. Throughput multiplier for triaging a board column.

Set notes AND survive workspace automations that rewrite the task name / parse dates out of notes text (Rules and some integrations do this): write notes, wait settle_ms, then re-assert name + due_on. Use instead of raw notes edits on automated boards.

List a project's task templates (repeatable task blueprints). Paginated.

Create a new task from a task template (repeatable intake/ops task). Returns an async job whose new_task holds the created task.

Create a new project from a project template (repeatable board setup). Returns an async job whose new_project holds the created project.

Duplicate an existing project (clone a board with its structure). include = fields to copy (array or comma string, e.g. ["members","task_notes","task_assignee"]). Returns an async job.

Create a workspace custom field (design the board schema). resource_subtype ∈ text|number|enum|multi_enum|date|people. For enum/multi_enum pass enum_options:[{name,color?}].

Attach an existing custom field to a project (addCustomFieldSetting), optionally important/positioned. Pairs with asana_create_custom_field to build a board.

Add an option to an existing enum/multi_enum custom field (extend a dropdown without recreating the field).

Add member(s) to a project (e.g. add a teammate to a new board).

Reorder a section within its project (move a board column). Provide before_section or after_section (section GIDs).

Poll an async job by GID (from duplicate_task/duplicate_project/instantiate_* tools). Returns status (not_started|in_progress|succeeded|failed) and the new_task/new_project GID once done.

Resolve a partial NAME → GID across the workspace for any resource type (task|project|user|tag|portfolio|project_template|goal). Fast lookup when you do not know the GID.

Remove a task from a project (un-add a board card). Symmetric with asana_add_to_project.

Re-parent a task: make it a subtask of parent_gid, or detach to top level (parent_gid:null). Optional insert_before/insert_after sibling GIDs.

Update a project: name, notes, color, archived, public, default_view, dates.

Rename a section.

Detach a custom field from a project (removeCustomFieldSetting). Symmetric with asana_add_field_to_project.

Fetch one custom field by GID — type, precision, and full enum_options (name+GID) list.

List ALL custom fields defined in the workspace (design discovery — find a field GID to attach to a board). Paginated.

Create a portfolio (group projects for North-Star-style tracking).

Add a project/portfolio item to a portfolio.

Remove an item from a portfolio.

Fetch workspace metadata (name, is_organization, email_domains).

Find TRUE duplicate tasks. Dedupes by GID FIRST — one task on N boards = multi_homed (shared membership, reported separately, NOT a dup; deleting it removes the real task from EVERY board) — then groups DISTINCT gids by name. Scan one project/section, or projects[] for cross-board. Returns {multi_homed, true_duplicate_clusters}. Read-only — reason before you delete.

DESTRUCTIVE — permanently delete a project. Requires confirm:true (C13 gate). No-op + gate message otherwise.

DESTRUCTIVE — delete a section (Asana requires it be empty, or moves its tasks out). Requires confirm:true (C13 gate).

Fetch a project's custom field settings — live field GIDs, types, and enum option GIDs. Use this to derive field/option GIDs live instead of trusting hand-coded maps that drift.

COMPOSITE: one-call daily brief — incomplete tasks bucketed into overdue / due_today / upcoming (within horizon_days) + blocked (due-window tasks waiting on an incomplete dependency), with a summary count. Defaults to "me"; pass user= for a teammate or user="all" for the whole workspace. Built on the search API (caps at 100 by due date).

COMPOSITE: per-project health across a portfolio — incomplete, overdue, and completed-in-window counts + current status, sorted by overdue. Scope via projects:[gids] (best), portfolio_gid, or default to all non-archived workspace projects (capped at max_projects). One task-list call per project; caps are reported, never silent.

COMPOSITE: bulk-create tasks from a triaged list in ONE call (fills the gap — no bulk CREATE existed). The model reads the inbox/note, extracts items, and passes them here. Per-item project/assignee/section/due override the defaults; default_assignee falls back to ASANA_DEFAULT_ASSIGNEE, else "me". Continues past individual failures; returns a per-item created/failed summary with permalinks.

COMPOSITE: one person's FULL incomplete queue — paginated (NOT capped at 100 like the search API), bucketed by due (overdue / due_today / this_week / later / no_due) with a per-project count map. Default user = "me"; pass user= for a teammate (the PAT-owner-only restriction on My Tasks does not apply — this uses /tasks?assignee=). The right call for "what is X sitting on?" and hand-off reviews.

COMPOSITE: roll up ONE board (project) — active tasks grouped by section, an amount custom field summed per section and in total (e.g. "Deal $", "Claim $"), an optional secondary amount, and every task whose deadline (any named date custom fields + due_on) has passed, with days overdue and WHICH field fired. Ranked by amount descending. Fields may be given by GID or by exact name (resolved live via the project's custom_field_settings, so nothing is hard-coded).