Overview

Asana offers a Model Context Protocol (MCP) server that allows AI assistants and other applications to access the Asana Work Graph. This server provides a way to interact with your Asana workspace through various AI platforms and tools that support MCP.

With this server, you can:

1. Access Asana data from compatible AI applications
2. Create and manage tasks and projects through natural language
3. Generate reports and summaries based on Asana data
4. Analyze project data and get AI-powered insights

Example requests:

1. "Find all my incomplete tasks due this week"
2. "Create a new task in the Marketing project assigned to me"
3. "List all sections in the Product Launch project"
4. "Show me the status of the Q2 Planning project"

Requirements

1. A compatible MCP client (Streamable HTTP is supported). There is a partial list of existing clients here!
2. The above MCP client app (or the Asana MCP app, for beta clients) must not be blocked in your workspace via Asana app management. If it is, you will be prompted to send a request for your admin to unblock the app for your domain when trying to authorize.

Connecting to Asana's MCP Server

The Asana MCP V2 server is available at: https://mcp.asana.com/v2/mcp.

This server requires authentication with your Asana account. When connecting, you'll be prompted to authorize the application to access your Asana data.

📘

Listing available tools

To view all available tools and their current parameters, use the tools/list MCP command within your MCP client. This ensures you always have the most up-to-date list of supported tools.

Subscribe to our changelog to stay informed about tool updates and changes.

Using with Claude

The Asana app in Claude brings your work graph directly into Claude conversations, allowing you to turn AI-powered discussions into actionable work without leaving Claude.

For complete setup instructions and usage guidance, see Asana app in Claude in the Asana Help Center.

For Claude Code Users (via beta version of MCP server)

1. Install and configure Claude Code locally on your computer.
2. Run the following command in Claude Code chat to add Asana MCP to Claude Code:

/plugin install asana@claude-plugins-official

3. Authenticate to Asana when prompted.

Using with ChatGPT

The Asana app in ChatGPT connects your Asana work with ChatGPT's AI capabilities. From a single ChatGPT conversation, you can check on portfolios, create and assign tasks, kick off new projects, and review work—all without switching between tools.

For complete setup instructions and usage guidance, see Asana for ChatGPT in the Asana Help Center.

Using with Cursor (via beta version of MCP server)

1. Go to your Cursor editor's settings ("Settings" > "Cursor Settings")
2. "Tools & MCP" > "New MCP Server"
3. Add the following to your mcp.json:
   JSON

           "asana": {
               "command": "npx",
               "args": ["mcp-remote", "https://mcp.asana.com/sse"]
           }

4. Save your mcp.jsonfile. If this is your first time using the integration, you'll be prompted to authenticate
   NOTE: If you run into Internal Server Erroryou can delete your local ~/.mcp-authdirectory rm -rf ~/.mcp-auth.
   WARNING: if you have other applications that might be using this directory ~/.mcp-auth you will need to re-auth (EX: other applications that use mcp-remote)
5. Once authenticated, you can start using Cursor with Asana

Using with other MCP clients

For MCP-compatible clients:

1. Configure your client to connect to https://mcp.asana.com/v2/mcp
2. Ensure your client supports OAuth authentication and Streamable HTTP transport
3. Set up the connection according to your client's documentation
4. Authenticate with your Asana account when prompted

For developers building MCP integrations, see Integrating with Asana's MCP Server.

Managing access

Customers in Asana's Enterprise+ or Legacy Enterprise tiers can use Asana's app management to allow or block Asana MCP clients. For clients using the v2 URL above, this will be a per-client configuration by blocking or allowing the associated app. For beta clients, blocking or allowing the single "Asana MCP" app will apply to all MCP clients using the v1 URL.

Customers in other tiers may contact Asana Support to block the Asana MCP app for beta v1 clients. Super admins must make the support request.

Troubleshooting

Authentication fails:

1. Try logging out of your Asana account and logging back in
2. If you see a "Client not found" error, try:
   1. Removing the Asana MCP integration within your client and adding it back
   2. Using the beta MCP server URL instead: https://mcp.asana.com/sse. If this works, note that the beta server is deprecated and will be shut down on on 05/11/2026, so if the client is not updated by its developer to use the new v2 server before then you will lose access.
3. Verify you have the necessary permissions in your Asana workspace

Connection issues:

1. Ensure your MCP client supports Streamable HTTP transport
2. Check that your client can handle OAuth authentication flows
3. Verify the MCP server URL is https://mcp.asana.com/v2/mcp

For additional help with Asana's MCP server, contact Asana Support.

Resources

• Integrating with Asana's MCP Server - Developer integration guide
• Asana app in Claude - Claude user guide
• Asana for ChatGPT - ChatGPT user guide
• API Changelog - Stay updated on changes

Note: This page provides a technical overview for developers and technical users. For end-user setup guides specific to your AI assistant, please visit the Asana Help Center links above.