Asana

Connect your company's Asana workspace to Cakewalk so agents can search tasks, read project context and post updates through the gateway.

Connect your company's Asana workspace to Cakewalk's MCP Gateway. Every agent tool call against Asana passes through the gateway and is evaluated against your Policies.

Requirements

• An Asana workspace member who can create apps at app.asana.com/0/my-apps.

• Access to the workspace you plan to connect, so you can add it to the app's distribution list.

Required Scopes

The Asana MCP server does not require custom OAuth scopes. Asana issues an access token with the default scope, which covers every available MCP tool.

Step 1: Create an Asana MCP App

1. Open https://app.asana.com/0/my-apps and sign in.

2. Click Create new app.

3. Enter the app name (for example, Cakewalk).

4. Select MCP app as the app type.

5. Click Create app.

You land on the app's configuration page. The Client ID and Client secret appear at the top. Leave the page open.

Step 2: Configure the Redirect URL

1. In the left sidebar, click OAuth.

2. Under Redirect URL, paste this URL:

https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback

1. Save.

Step 3: Configure Workspace Access

1. In the left sidebar, click Manage distribution.

2. Under Distribution method, choose Specific workspaces.

3. Add your company's Asana workspace.

4. Save changes.

Specific workspaces keeps the app scoped to your workspace only. The alternative, Any workspace, requires Asana review and is not needed here.

Step 4: Paste Credentials Into Cakewalk

1. Back on the Asana app's main configuration page, copy the Client ID and Client secret.

2. Open https://app.getcakewalk.io.

3. Go to All Connections.

4. Find Asana.

5. Click Edit credentials.

6. Paste the Client ID and Client secret.

7. Save.

Verifying It Works

The Asana Connection card flips to Active on All Connections. From an agent platform connected to Cakewalk, ask the agent to list your recent Asana tasks. If Asana returns results, the Connection is live.

Troubleshooting

• This app is not available to your Asana workspace or organization: open Manage distribution, confirm Specific workspaces is the chosen method, and confirm your workspace is on the list.

• Invalid scope(s) requested: do not configure a custom scope on the Asana app. The MCP server uses the default scope and rejects requests that pass an explicit scope value.

• Redirect URI mismatch on consent: the value under Redirect URL must match https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback exactly, with no trailing slash.

Learn More

• Integrating with Asana's MCP Server

• Asana OAuth documentation