asana-admin-mcp
asana-admin-mcp
MCP server — Asana の構造を整理するためのもの: ポートフォリオ、カスタムフィールド / ドロップダウン、プロジェクト、セクション 標準の Asana コネクタでは対応できない部分を補完します(標準コネクタは task/read 中心)
⚠️ Dashboard はできない — そしてこれはこの MCP の制限ではありません
Asana は Dashboard / chart / widget / project view tab の public API を公開していません。 (公式 OpenAPI spec の 175 エンドポイントすべてを確認済み — 1つもありません)
自動化できる唯一の方法は project_duplicate です。仕様では、プロジェクトを duplicate すると
Project Views(List / Board / Dashboard タブ)は常にコピーされ、無効化できません。
→ 「テンプレート用プロジェクト」に Dashboard を設定しておき、新しいプロジェクトが必要になるたびに duplicate します。
🟡 未検証: 仕様には「Project Views」がコピーされると書かれていますが、Dashboard に設定した chart が コピーされるのか、それとも空のタブだけなのかは明記されていません。API では確認できず(chart を読み取る endpoint がない)、目視で確認する必要があります。 2026-08-17 の smoke test では chart のないプロジェクトを duplicate したため、この点は未解決のままです。
注: Project Template は Dashboard を引き継ぎません(Asana フォーラムで保留中の feature request です)。 template ではなく duplicate を使用してください。
Related MCP server: asana-mcp
インストール
1. 先に Asana token を取得する(各自が自分のものを持つ必要があります)
GET-TOKEN.md に従って → ~/.asana_token に保存します
printf '%s' 'วาง_token_ตรงนี้' > ~/.asana_token && chmod 600 ~/.asana_tokentoken は個人の権限に紐づいています。他人のものを使うのは禁止です。Asana のログには token の所有者の名前が表示されます。
2. plugin をインストール(推奨)
Claude Code で次の 2 行を入力します:
/plugin marketplace add plakorp/asana-admin-mcp
/plugin install asana-admin@asana-admin-mcpClaude Code が repo を clone して npm ci を実行し、MCP を登録します。~/.claude.json を触る必要はありません。
後から更新するには /plugin update を実行します。
マシンに Node 20+ が必要です(node -v で確認)
方法 2 — 手動インストール(plugin を使いたくない場合)
repo を clone して ติดตั้ง-asana-admin-mcp.command をダブルクリックします
スクリプトが token を尋ね、npm install を実行し、~/.claude.json を書き込みます(毎回 backup します)。
2 つの方法を同時に使わないでください。
asana-adminという名前の MCP が 2 つ重複して登録されます。
Token は最初に環境変数 ASANA_TOKEN から読み取り、なければ ~/.asana_token にフォールバックします。
→ token は repo には一切含まれず、~/.claude.json に置く必要もありません。
ツール (21)
すべての tool は gid を受け取ります(名前ではありません)。asana_find で名前を gid に変換してから使用します。
検索
Tool | 説明 |
| 自分自身 + すべての workspace(ほぼすべての create で |
| 名前から gid を typeahead 検索 — project / portfolio / custom_field / task / team / user / tag / goal |
| workspace 内、または project/portfolio に紐づいた custom field — |
ポートフォリオ
Tool | 説明 |
| ポートフォリオを作成 |
| rename / 色の変更 / public |
| ポートフォリオ内のプロジェクトを実際の表示順で確認 |
| ポートフォリオにプロジェクトを追加 + 位置を指定可能( |
| プロジェクトを外す( |
カスタムフィールド / ドロップダウン
Tool | 説明 |
| フィールドを作成 — |
| rename / description の編集 |
| ドロップダウンに値を追加 + 位置を指定可能 |
| rename / 色の変更 / |
| ドロップダウン内の値の並び順を変更 |
| フィールドを project または portfolio に紐付け( |
Asana では ドロップダウンの値を削除できません。できるのは
enabled:falseのみです。その値を選択していたタスクには以前の値が保持されます。
プロジェクト / セクション
Tool | 説明 |
| プロジェクトを作成(organization では |
| rename / notes / 色 / |
| プロジェクトをコピーし Dashboard も引き継ぐ — dashboard 問題の唯一の解決策(job を返し、非同期で実行) |
| セクションを順番 + gid 付きで表示 |
| セクションを追加 + 位置を指定可能 |
| セクションの rename(名前変更) |
| セクションの並び順を変更 |
project / portfolio / custom field を意図的に削除する tool はありません — これらを削除すると復元できないため、Web 画面で行ってください。
色(portfolio / project / enum option で使用可能)
none red orange yellow-orange yellow yellow-green green blue-green
aqua blue indigo purple magenta hot-pink pink cool-gray
テスト
ASANA_TOKEN=$(cat ~/.asana_token) npm run smoketoken の最初の workspace に ZZ-mcp-smoke-* で始まる実データを作成 → すべての tool を検証 → すべて自分で削除する
token を指定しない場合は前半のみ実行されます(server boot + list tools)
動作上の注意
429 →
Retry-Afterに従って自動リトライを 3 回実行Asana のエラーは API からの実際のメッセージをそのまま返します(どの field が欠けているか / どの gid が間違っているかを示します)。status code だけではありません
送信しなかったフィールドは変更されません —
nameだけを送ったportfolio_updateは色をリセットしません
Available Tools
23 toolsasana_findFind gid by nameA
Typeahead search that turns a name you can see in the Asana UI into the gid every other tool needs.
Inputs: type (required), query (required), workspace_gid (required), count.
asana_list_custom_fieldsList custom fieldsA
Custom fields in a workspace, or the ones attached to a project/portfolio. Returns enum_options with their gids — the input for every dropdown tool.
Inputs: project_gid, portfolio_gid, workspace_gid.
asana_whoamiWho am IA
The authenticated user and their workspaces. Call this first — almost every create call needs a workspace_gid.
Inputs: no named parameters.
custom_field_attachAttach custom field to project or portfolioB
Make an existing custom field available on a project or a portfolio.
Inputs: custom_field_gid (required), project_gid, insert_after, is_important, +2 more.
custom_field_createCreate custom fieldB
Create a workspace custom field. For a dropdown use type 'enum' (single-select) or 'multi_enum' (multi-select) and pass enum_options.
Inputs: name (required), type (required), workspace_gid (required), precision, +2 more.
custom_field_updateRename / update custom fieldA
Change a custom field's name or description. Enum values are edited with the enum_option_* tools.
Inputs: custom_field_gid (required), name, description.
enum_option_createCreate dropdown valueA
Add a value to an enum / multi_enum custom field. Appended at the end unless you give a position.
Inputs: name (required), custom_field_gid (required), color, insert_after, +1 more.
enum_option_reorderReorder dropdown valueA
Move an existing dropdown value to a new position within its custom field.
Inputs: enum_option_gid (required), custom_field_gid (required), after_enum_option, before_enum_option.
enum_option_updateRename / disable dropdown valueA
Rename, recolor, or disable a dropdown value. Asana has no delete — set enabled:false to retire a value; tasks already holding it keep it.
Inputs: enum_option_gid (required), name, color, enabled.
member_addAdd member to project or portfolioA
Give a person or team access to a project or portfolio. NOTE Asana's own limits: a project can only be admin / editor / commenter — there is no view-only level for projects, so 'commenter' is the least access possible. A portfolio can be admin / editor / viewer.
Inputs: member_gid (required), parent_gid (required), access_level (required).
member_listList members of a project or portfolioB
Who currently has access, and at what level.
Inputs: parent_gid (required).
portfolio_add_itemAdd project to portfolioA
Add a project (or sub-portfolio) to a portfolio, optionally at a chosen position. Adding an item that is already present moves it to that position.
Inputs: item_gid (required), portfolio_gid (required), insert_after, insert_before.
portfolio_createCreate portfolioC
Create a portfolio in a workspace.
Inputs: name (required), workspace_gid (required), color, public.
portfolio_list_itemsList portfolio itemsC
The projects/portfolios inside a portfolio, in their current display order.
Inputs: portfolio_gid (required).
portfolio_remove_itemRemove item from portfolioA
Remove a project from a portfolio. This also drops any portfolio-level custom field values set on that project.
Inputs: confirm (required), item_gid (required), portfolio_gid (required).
portfolio_updateRename / update portfolioA
Change a portfolio's name, color, or visibility. Only the fields you pass are touched.
Inputs: portfolio_gid (required), name, color, public.
project_createCreate projectB
Create a project in a workspace (team_gid is required in an organization).
Inputs: name (required), workspace_gid (required), color, notes, +3 more.
project_duplicateDuplicate projectA
Copy a project. Tasks, project views (List/Board/Dashboard tabs) and rules are always carried over — this is the only way to give a new project a preconfigured Dashboard, since Asana exposes no dashboard/chart API. Returns a job; duplication finishes asynchronously.
Inputs: name (required), project_gid (required), include, team_gid.
project_list_sectionsList project sectionsB
Sections of a project in display order — the gids needed by section_reorder.
Inputs: project_gid (required).
project_updateRename / update projectC
Change a project's name, notes, color, default view, or archived state.
Inputs: project_gid (required), name, color, notes, +3 more.
section_createCreate sectionB
Add a section to a project, optionally at a chosen position.
Inputs: name (required), project_gid (required), insert_after, insert_before.
section_reorderReorder sectionC
Move an existing section to a new position within its project.
Inputs: project_gid (required), section_gid (required), after_section, before_section.
section_updateRename sectionA
Rename an existing section.
Inputs: name (required), section_gid (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Each tool targets a distinct resource and action: user info, members, projects, portfolios, custom fields, sections, and search. There is no overlap in purpose, and descriptions clearly differentiate them.
Most tools follow a consistent 'resource_verb' pattern (e.g., portfolio_create, custom_field_attach, section_reorder), but a few use a generic 'asana_' prefix (asana_whoami, asana_find) and 'project_list_sections' mixes resource prefixes, creating minor inconsistency.
With 23 tools, the server is slightly on the higher side but still well-scoped for Asana administration. Each tool serves a clear purpose, and the count is justified by the breadth of admin operations covered.
The tool set covers core admin operations like project/portfolio/folder/section CRUD, custom field management, and member access. However, it lacks delete operations for projects, portfolios, and members, and is missing a general listing tool for projects/portfolios, which are notable gaps for an admin surface.
Maintenance
Related MCP Connectors
Read and write Mission Control state via MCP — projects, tasks, subtasks, templates, status updates.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
A MCP server built for developers enabling Git based project management with project and personal…
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that uses AI to generate structured Asana project plans from diverse sources like text, PDFs, and meeting transcripts. It enables users to preview, generate, and directly sync detailed task lists, subtasks, and dependencies into Asana.1MIT
- AlicenseBqualityCmaintenanceMCP server for the Asana API that allows AI agents to read and optionally write to Asana tasks, comments, and custom fields, with tiered access controls and no delete tools.832 npmMIT
- AlicenseNot gradedqualityDmaintenanceHigh-performance MCP server that transforms how AI assistants interact with Asana, enabling complex task hierarchies and batch operations for efficient project management.6 npm3MIT
- AlicenseAqualityDmaintenanceA local MCP server for Asana that uses a personal access token to read and manage Asana projects, tasks, sections, and comments via the standard Asana REST API.8MIT