MCP Directory

How to add Asana MCP Server (official remote) to Windsurf

Asana's official hosted MCP server (V2) for tasks, projects, and workspace analytics. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 0★ · http · oauth · official

Windsurf 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": {
      "serverUrl": "https://mcp.asana.com/v2/mcp"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Asana MCP Server (official remote) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Asana MCP Server (official remote)'s tools become available to Cascade.

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 Windsurf

search_objects

Search across Asana objects (tasks, projects, etc.) by text and filters

search_tasks

Advanced task search by text, date, status, assignee, project, portfolio, tag, and custom fields

get_task

Fetch a single task with its fields

get_tasks

Fetch multiple tasks

create_task

Create a task in a project, workspace, or as a subtask

update_task

Update fields on an existing task

create_project

Create a new project

get_project

Fetch 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) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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.

View repo Full Asana MCP Server (official remote) page