Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Project management - official Asana server

Asana MCP server

Hosted MCP server that gives AI clients read and write access to the Asana Work Graph: tasks, projects, portfolios, status updates, users, teams and AI Teammates. Each session is scoped to the workspace chosen at authorization. Asana hosts it at https://mcp.asana.com/v2/mcp with OAuth auth.

Last verified 15 tools8 sources

Install

Claude Code

About Claude Code
Terminal
claude mcp add --transport http \
  --client-id YOUR_CLIENT_ID \
  --client-secret \
  --callback-port 8080 \
  asana https://mcp.asana.com/v2/mcp

Codex

About Codex
TOML
[mcp_servers.asana]
command = "npx"
args = [
  "-y",
  "mcp-remote@latest",
  "https://mcp.asana.com/v2/mcp",
  "3334",
  "--static-oauth-client-info",
  "@/Users/YOUR_USERNAME/.asana/mcp_oauth_client.json",
  "--resource",
  "https://mcp.asana.com/v2"
]

Cursor

About Cursor
JSON
{
  "mcpServers": {
    "asana": {
      "url": "https://mcp.asana.com/v2/mcp",
      "auth": {
        "CLIENT_ID": "${env:ASANA_CLIENT_ID}",
        "CLIENT_SECRET": "${env:ASANA_CLIENT_SECRET}"
      }
    }
  }
}

Tools

search_objects
Universal search across Asana resource types, including tasks, projects, portfolios, goals, users and AI Teammates.
get_task
Returns full details for a single task.
get_tasks
Returns a filtered list of tasks by project, section, tag, user task list or assignee.
get_my_tasks
Returns tasks assigned to the currently authenticated user.
search_tasks
Advanced full-text task search with complex filters (Premium accounts only).
get_project
Returns full details for a single project.
get_projects
Returns a list of projects in the workspace.
get_portfolios
Returns portfolios owned by the authenticated user in the current workspace.
get_status_overview
Returns an aggregated status report for projects or portfolios found by keyword search.
get_users
Returns a list of users in the workspace.
create_tasks
Creates up to 50 tasks immediately, without a confirmation step.
create_project
Creates a new project, optionally with sections and tasks.
update_tasks
Updates up to 50 tasks in a single operation.
add_comment
Adds a comment to a task.
create_project_status_update
Posts a status update to a project or portfolio.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • V2 uses OAuth with a pre-registered client: create an MCP app in the Asana developer console to get a client ID and secret, and register the exact redirect URL your client uses (Claude Code http://localhost:8080/callback; Cursor cursor://anysphere.cursor-mcp/oauth/callback; VS Code needs http://127.0.0.1:33418/ and https://vscode.dev/redirect).
  • VS Code setup is a UI flow (MCP: Add Server) with no config snippet.
  • The Codex, Windsurf and Kiro setups use the community mcp-remote bridge, which Asana does not support.
  • The tools reference links a changelog post titled 'New V2 MCP server now generally available'.
  • The beta V1 server at https://mcp.asana.com/sse was deprecated with a shutdown date of 05/11/2026.
  • MCP tokens do not work with the REST API.
  • Enterprise+ admins can allow or block MCP clients through app management.
  • Interactive preview tools (create_task_preview, create_project_preview, search_tasks_preview) render only in Claude and ChatGPT.

More MCP servers for project management

Related reading

FAQ

What does the Asana MCP server do?

Hosted MCP server that gives AI clients read and write access to the Asana Work Graph: tasks, projects, portfolios, status updates, users, teams and AI Teammates. Each session is scoped to the workspace chosen at authorization. The vendor documents 15 tools, including search_objects, get_task, get_tasks and get_my_tasks.

How do I add the Asana MCP server to Claude Code?

Asana documents a Claude Code config; copy it from the Claude Code section of this page. Snippets for Codex and Cursor are there too.

Does the Asana MCP server need authentication?

Yes, OAuth. Transport: Streamable HTTP. Status: GA, last checked October 17, 2026.

Sources

Last verified against 8 Asana pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.