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 を使用してください。

インストール

1. 先に Asana token を取得する（各自が自分のものを持つ必要があります）

GET-TOKEN.md に従って → ~/.asana_token に保存します

printf '%s' 'วาง_token_ตรงนี้' > ~/.asana_token && chmod 600 ~/.asana_token

token は個人の権限に紐づいています。他人のものを使うのは禁止です。Asana のログには token の所有者の名前が表示されます。

2. plugin をインストール（推奨）

Claude Code で次の 2 行を入力します:

/plugin marketplace add plakorp/asana-admin-mcp
/plugin install asana-admin@asana-admin-mcp

Claude 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 に変換してから使用します。

検索

ポートフォリオ

カスタムフィールド / ドロップダウン

Asana では ドロップダウンの値を削除できません。できるのは enabled:false のみです。その値を選択していたタスクには以前の値が保持されます。

プロジェクト / セクション

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 smoke

token の最初の workspace に ZZ-mcp-smoke-* で始まる実データを作成 → すべての tool を検証 → すべて自分で削除する token を指定しない場合は前半のみ実行されます（server boot + list tools）

動作上の注意

• 429 → Retry-After に従って自動リトライを 3 回実行

• Asana のエラーは API からの実際のメッセージをそのまま返します（どの field が欠けているか / どの gid が間違っているかを示します）。status code だけではありません

• 送信しなかったフィールドは変更されません — name だけを送った portfolio_update は色をリセットしません