Asana MCP Server

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.

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

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?}].

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

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).

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

Create a subtask under a parent task.

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).

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).

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

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.

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

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.

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

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.

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.

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

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

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

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

Fetch workspace metadata (name, is_organization, email_domains).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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=<gid> for a teammate or user="all" for the whole workspace. Built on the search API (caps at 100 by due date).

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

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=<gid>, or asana_user_queue. Paginated.

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.

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

Remove follower(s) from a task.

Remove an item from a portfolio.

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

Remove a tag from a task.

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

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).

Set custom fields on a task using correct type handling. Fixes: multi_enum arrays and date object wrappers that fail via 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.

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

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.

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.

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.

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.

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

Rename a section.

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=<gid> 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.