Asana MCP

How to Install and Use Asana MCP

Asana MCP is an experimental app integration that connects Asana with AI assistants and apps via a Model Context Protocol (MCP) server. It lets you manage your Asana workspace from outside the platform, using natural language commands. Setting it up is straightforward if you follow the steps below.

Step 1: Prepare Your Workspace

Before installing Asana MCP, you need to make sure you have the right permissions and tools. Only Workspace Owners or Primary Owners can set up the MCP connection in Claude.ai or other clients.

Here’s what you should do first:

1. Make sure you have a Claude Enterprise or Teams account.
2. Confirm you are a Workspace Owner or Primary Owner in your Asana workspace.
3. Check that the app named “Asana MCP” is not blocked via Asana’s app management settings. If unsure, try connecting and authorizing the app - you will be prompted if it’s blocked.

Step 2: Add Asana MCP as a Server in Claude.ai

Once your workspace is ready, you can add the Asana MCP server in Claude.ai:

1. Go to Settings in Claude.ai.
2. Find the Integrations section.
3. Click Add server.
4. Enter Asana as the server name.
5. Put the server URL as https://mcp.asana.com/sse
6. Click Add server.
7. Authenticate with your Asana account via the OAuth prompt.
8. Choose which Asana tools you want to enable for your workspace.
9. Click Save.

Now the server is connected and you can use Asana from Claude.

Step 3: Use Asana MCP in Claude and Other Compatible Clients

To start managing your Asana data using natural language commands, do the following:

1. Open Claude.ai and click the tools menu (next to the search icon).
2. Select Asana from the list of available integrations.
3. If this is your first time, authenticate your Asana account.
4. After authentication, you can begin using commands like:
   • “Find all my incomplete tasks due this week”
   • “Create a new task in the Marketing project assigned to me”
   • “List all sections in the Product Launch project”

Step 4: Install Asana MCP in Claude.Code (Optional)

For developer users running Claude.Code locally, here is the simple terminal command to add the Asana MCP server:

claude mcp add --transport sse asana https://mcp.asana.com/sse

After entering the command, authenticate if prompted. Then open the Claude.Code chat in the terminal by typing:

claude

You’re now ready to use Asana via MCP in Claude.Code.

Step 5: Set Up Asana MCP in Cursor Editor (Optional)

If you use Cursor editor, here’s how to add Asana MCP:

1. Go to Settings > Cursor Settings.
2. Navigate to MCP > Add new global MCP server or Tools & Integrations > New MCP Server.
3. Paste this snippet into your mcp.json file:

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

1. Save your file and authenticate when asked.

Troubleshooting Tips

If you get an internal server error, try removing your local authentication folder with this command:

rm -rf ~/.mcp-auth

Note that deleting this folder means you will need to re-authenticate other MCP apps using that folder as well.

Also, if you face issues like “Client not found” or invalid redirect URI errors:

• Log out and log back into your Asana account.
• Remove and re-add the Asana MCP integration in your client.
• Make sure your MCP client supports SSE-based servers and OAuth flows.
• Contact the maintainers or Asana Support if needed.

---

Following these steps will help you install and get started with the Asana MCP server so you can interact with your Asana workspace easily from various AI tools and apps.