How to add Asana MCP Server (official remote) to Claude Desktop
Asana's official hosted MCP server (V2) for tasks, projects, and workspace analytics. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 15, 2026 ยท 0โ ยท http ยท oauth ยท official
Claude Desktop config for Asana MCP Server (official remote)
Add remote MCP URL https://mcp.asana.com/v2/mcp and complete OAuth{
"mcpServers": {
"asana-mcp-server-official-remote": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.asana.com/v2/mcp"
]
}
}
}Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.
Setup steps
- 1Open Claude Desktop โ Settings โ Developer โ Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the Asana MCP Server (official remote) config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm Asana MCP Server (official remote)'s tools appear under the ๐ tools menu.
Before you start
- An Asana account with access to the workspace you want to query
- An MCP client that supports Streamable HTTP transport and OAuth (e.g. Claude, ChatGPT, Claude Code, Cursor, VS Code)
- No API token to manage โ authentication is handled via OAuth in the browser at connect time
- On Enterprise+/Legacy Enterprise plans, the MCP client must not be blocked in your workspace's app-management settings
What Asana MCP Server (official remote) can do in Claude Desktop
search_objectsSearch across Asana objects (tasks, projects, etc.) by text and filters
search_tasksAdvanced task search by text, date, status, assignee, project, portfolio, tag, and custom fields
get_taskFetch a single task with its fields
get_tasksFetch multiple tasks
create_taskCreate a task in a project, workspace, or as a subtask
update_taskUpdate fields on an existing task
create_projectCreate a new project
get_projectFetch a single project
Security
Access is delegated through Asana OAuth and constrained to your existing workspace permissions; no API key is stored locally. Use the V2 /v2/mcp endpoint, as the V1 SSE endpoint was retired in May 2026.
Asana MCP Server (official remote) + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Asana MCP Server (official remote) config there under the "mcpServers" key and restart the client.
Is Asana MCP Server (official remote) safe to use with Claude Desktop?
Access is delegated through Asana OAuth and constrained to your existing workspace permissions; no API key is stored locally. Use the V2 /v2/mcp endpoint, as the V1 SSE endpoint was retired in May 2026.
What is the server URL and transport?
The current V2 endpoint is https://mcp.asana.com/v2/mcp over Streamable HTTP. The older SSE endpoint (https://mcp.asana.com/sse) and the V1 server are being deprecated, so use V2.
How does authentication work? Do I need an API token?
No manual token is needed. The server uses OAuth โ you authorize in the browser with your Asana login, and the integration inherits your existing Asana permissions.
Which AI clients can connect?
Any MCP client that supports Streamable HTTP and OAuth, including Claude, ChatGPT, Claude Code, Codex, Cursor, and VS Code. Asana also ships native app integrations for Claude and ChatGPT.