Asana MCP Server

Asana MCP Server とは？

Asana MCP Server（@roychri/mcp-server-asana）は、コミュニティが開発した asana mcp server です。Claude Desktop、Claude Code、Codex などの AI アシスタントから、Asana API を通じて Asana のタスク、プロジェクト、セクション、タグ、コメントを読み取り・管理できます。

npx を使ってローカルで stdio 経由で動作し、Asana のパーソナルアクセストークンで認証します。独立した開発者が MIT ライセンスで保守しており、Asana の公式プロジェクトではありません。Asana は公式のリモート MCP サーバー https://mcp.asana.com/v2/mcp も提供しています。詳しくは後述の比較セクションを参照してください。

Asana MCP Server の使い方

Node.js（npx の実行用）、Asana アカウント、Asana のパーソナルアクセストークンが必要です。トークンは Asana 開発者コンソール app.asana.com/0/my-apps で発行でき、手順は Asana のパーソナルアクセストークンガイドに記載されています。

サーバーは次の 2 つの環境変数を読み込みます。

• ASANA_ACCESS_TOKEN（必須）：Asana のアクセストークン。
• READ_ONLY_MODE（任意）：true に設定すると、データを作成・更新・削除するすべてのツールと create-task プロンプトが無効になります。

設定後は、アシスタントに Asana のタスク、プロジェクト、コメントについて質問するだけです。README によると、プロンプトに「asana」という単語を含めると、モデルが適切なツールを選びやすくなります。

Claude Desktop

claude_desktop_config.json に以下を追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "asana": {
      "command": "npx",
      "args": ["-y", "@roychri/mcp-server-asana"],
      "env": {
        "ASANA_ACCESS_TOKEN": "your-asana-access-token"
      }
    }
  }
}

Claude Code

1 つのコマンドでサーバーを登録します。<TOKEN> はアクセストークンに置き換えてください。

claude mcp add asana -e ASANA_ACCESS_TOKEN=<TOKEN> -- npx -y @roychri/mcp-server-asana

Codex

~/.codex/config.toml に以下を追加します。

[mcp_servers.asana]
command = "npx"
args = [
  "-y", "@roychri/mcp-server-asana"
]
env = {ASANA_ACCESS_TOKEN= "<TOKEN>"}

Cursor と VS Code

README には Cursor や VS Code 専用の手順はありません。stdio MCP サーバーを起動できるクライアントであれば、同じ npx -y @roychri/mcp-server-asana コマンドと環境変数 ASANA_ACCESS_TOKEN を使い、上記の Claude Desktop の JSON と同じ形式で設定できます。

未リリースの変更を試したい場合は、代わりに @roychri/mcp-server-asana@beta をインストールします。

Asana MCP Server の主な機能

• ワークスペース、プロジェクト、タスク、サブタスク、セクション、タグ、コメント、プロジェクトのステータス更新をカバーする 41 個のツール
• テキスト、担当者、完了状態、ブロック中・ブロック元の状態、添付ファイル、カスタムフィールドによる絞り込みと並べ替えに対応した高度なタスク検索
• タスクの依存関係・被依存タスクの管理と、サブタスクの親の付け替え
• すべての書き込みツールを非表示にする読み取り専用モード（テストや共有ワークスペースに便利）
• 3 つの組み込みプロンプト：task-summary、task-completeness、create-task
• ワークスペース（asana://workspace/{workspace_gid}）とプロジェクト（asana://project/{project_gid}）の MCP リソース
• npm からローカルで実行でき、必要なのはアクセストークン 1 つだけ（OAuth アプリは不要）

Asana MCP Server のツール

• ワークスペースと検索： asana_list_workspaces、asana_search_projects（プロジェクト名を正規表現で照合）、asana_search_tasks で対象を探します。asana_get_my_tasks はユーザー自身の My Tasks リストを返します。
• タスク： asana_get_task、asana_create_task、asana_update_task、asana_delete_task でタスクのライフサイクル全体を扱います。asana_get_multiple_tasks_by_gid は最大 25 件のタスクを一度に取得します。
• サブタスクと依存関係： asana_create_subtask、asana_get_subtasks、asana_set_parent_for_task、asana_add_task_dependencies、asana_add_task_dependents。
• プロジェクトとセクション： asana_get_project、asana_create_project、asana_update_project、asana_get_project_task_counts、asana_get_tasks_for_project に加え、asana_create_section や asana_add_task_to_section などのセクション用ツール。
• コメントとステータス更新： コメントには asana_get_task_stories と asana_create_task_story、ステータス更新には asana_get_project_statuses と asana_create_project_status を使います。
• タグ： タグの作成、更新、削除、一覧取得、付与を行うツール（例：asana_add_tag_to_task）。

Asana MCP Server のユースケース

• スプリント報告：「How many unfinished asana tasks do we have in our Sprint 30 project?」
• タスクの登録：会議メモを、指定したプロジェクト内の期日と担当者付きのタスクに変換します。
• ステータスの要約：task-summary プロンプトを使うか、「Asana の Website Redesign プロジェクトの最新ステータス更新を要約して」と依頼します。
• 計画の整理：タスク間に依存関係を追加したり、タスクをセクションに移動したり、親タスクの下にまとめたりします。
• 個人タスクの整理：「このワークスペースで未完了の自分の Asana タスクを一覧にして」。asana_get_my_tasks がこれを支えます。
• 安全な調査：READ_ONLY_MODE=true で実行し、エージェントが何も変更せずに質問へ回答できるようにします。

Asana MCP Server と代替ツールの比較

• Asana 公式 MCP サーバー：Asana がホストするリモートサーバー https://mcp.asana.com/v2/mcp は Streamable HTTP と OAuth を使い、Claude、ChatGPT、Claude Code、Codex、Cursor、VS Code 向けの設定手順が公開されています（Asana ドキュメント）。ローカルへのインストールは不要ですが、コーディング系クライアントでは OAuth アプリの client ID と client secret が必要です。旧ベータエンドポイント https://mcp.asana.com/sse は非推奨となり、停止日は 05/11/2026 とされています。ベンダーのサポートと OAuth を重視するなら公式サーバーを、ローカルプロセス・パーソナルアクセストークン・読み取り専用スイッチを好むならこのコミュニティプロジェクトを選びましょう。
• 他のプロジェクト管理ツール：チームが別のツールで作業を管理している場合は、ClickUp MCP Server、Trello MCP Server、Linear MCP Server も参照してください。

Asana MCP Server のトラブルシューティング

• 権限エラー：README では、利用中の Asana プランで API アクセスが許可されているか、claude_desktop_config.json にトークンが正しく設定されているかを確認するよう案内しています。
• 無料プランで検索結果が出ない、または失敗する：asana_search_tasks は Asana の検索機能を使い、README によるとプレミアムプランが必要です。無料プランでも動作する asana_get_tasks_for_project を使ってください。
• 書き込みツールが見当たらない：READ_ONLY_MODE が true になっていないか確認します。このモードでは作成・更新・削除ツールが削除されます。
• モデルが Asana を使わない：プロンプトに「asana」という単語を含めます。
• 変更をローカルでテストする：リポジトリのクローンで npm run inspector を実行すると MCP Inspector が開きます（クライアントポート 5173、サーバーポート 3000。CLIENT_PORT と SERVER_PORT で変更可能）。