PLANNING AND COLLABORATION / Asana
Asana MCP V2
Asana’s current workspace-scoped MCP connection for task, project and portfolio workflows.
“The Asana V2 MCP server is generally available and uses OAuth for authorization.”
01 / THE REASONING
Why this made the selection.
- Uses the current V2 endpoint and registered OAuth app flow, with a session tied to the selected workspace.
- The tool reference distinguishes standard direct writes from supported interactive preview tools.
- Asana’s V2 guide says an MCP token cannot exceed the authorizing user’s existing access to workspaces, projects, and tasks.
- Dynamic client registration is not supported, MCP tokens are not valid for the ordinary Asana API, and the client list does not imply an Asana endorsement.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- Official V2 setup and OAuth guide
- Current MCP tools reference
- Official client guidance
- https://developers.asana.com/docs/integrating-with-asanas-mcp-server
- https://developers.asana.com/docs/mcp-tools-reference
- https://developers.asana.com/docs/mcp-clients
- Round 2 reread of acquired publisher setup and permission evidence; see immutable wave review.
Our findings
- The reviewed documentation separates MCP-only tokens from REST API tokens and scopes the session to a workspace.
- Tool documentation explicitly distinguishes immediate standard writes from interactive preview behavior; no private server implementation was inspected.
- Asana says the MCP token does not grant permissions beyond the user and can only reach workspaces, projects, and tasks that user already has.
- The tools page repeats that a tool cannot access projects, tasks, or data the user cannot already view. MCP apps do not use permission scopes; authorization requests all available tools.
- Dynamic client registration is not supported on the V2 server, tokens issued for MCP apps only work with the MCP server, and inclusion on the client list does not imply endorsement by Asana.
- Tokens issued for MCP apps are limited to the MCP server and cannot be reused as standard Asana API tokens.
Not established by this review
- No MCP server or upstream package was installed or run.
- No authenticated account, API request, client handshake or write operation was tested.
- The resource was not executed and its tools were not called.
- The server was not called. A source review is not a runtime or security certification.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
- Create an MCP app in the Asana developer console and register the client redirect URL and intended distribution/workspaces.
- Configure the client for https://mcp.asana.com/v2/mcp with the registered OAuth credentials, then complete user authorization. Omit an explicit scope parameter, following the guide’s troubleshooting advice.
- Select the intended workspace and review direct write calls. Do not use the deprecated V1/SSE endpoint.
Before you start
- Asana account with access to the intended workspace
- A pre-registered Asana MCP OAuth app; dynamic client registration is not the documented path
- A compatible client with secure client-secret handling
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"mcpServers": {
"asana": {
"url": "https://mcp.asana.com/v2/mcp",
"auth": {
"CLIENT_ID": "${env:ASANA_CLIENT_ID}",
"CLIENT_SECRET": "${env:ASANA_CLIENT_SECRET}"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Official service setup ↗Checked
https://developers.asana.com/docs/integrating-with-asanas-mcp-server
Supports: summary, upstreamDescription, whySelected, bestFor, install, compatibility, transports, limitations, access
- Current Asana MCP tools ↗Checked
https://developers.asana.com/docs/mcp-tools-reference
Supports: install, compatibility, review, limitations, access
- Asana MCP clients ↗Checked
https://developers.asana.com/docs/mcp-clients
Supports: install, compatibility, review, limitations, access