Skip to main content

Set up the Asana MCP server

The Asana MCP server lets AI agents read and write Asana data — searching tasks, reading projects and portfolios, creating and updating tasks, and generating status reports. This guide covers creating an Asana MCP app, configuring OAuth, and connecting it to MintMCP as a remote MCP.

Prerequisites​

  • A MintMCP admin account
  • An Asana account with permission to create apps in the Asana developer console

Create an Asana MCP app​

Asana does not support dynamic client registration, so an admin must create an MCP app once to obtain the credentials MintMCP needs.

  1. Go to app.asana.com/0/my-apps.
Asana My apps page with the Create new app button
  1. Click Create new app.
  2. Enter an App name, for example MintMCP.
  3. Under App type, select MCP app.
  4. Check I agree to the Asana API Terms, then click Create app.
Create new app dialog with the App name field and API app / MCP app type options

After creation, configure the app's OAuth settings:

  1. Open the OAuth tab in the app's settings.
OAuth and permissions tab showing app credentials and the Add redirect URL button
  1. Under Redirect URLs, click Add redirect URL, enter https://app.mintmcp.com/oauth/callback, and click Add.
Add redirect URL dialog with the MintMCP OAuth callback URL
  1. Open the Manage distribution tab. Under Choose a distribution method, select Any workspace so any Asana user with an authorization link can use the app. To limit access, choose Specific workspaces instead and click Add workspace for each one.
Manage distribution tab with Specific workspaces and Any workspace options

Copy the client ID and secret​

The Client ID and Client secret appear on both the Basic information and OAuth tabs.

  1. Copy the Client ID.
  2. Copy the Client secret and store it somewhere secure.
Basic information tab showing the Client ID and Client secret fields

Add Asana to MintMCP​

Asana is pre-listed as a recommended server in the MintMCP MCP store. Asana does not support dynamic client registration, so you supply the client ID and secret from the app you created above.

  1. In MintMCP, go to MCP store > Manage store.
  2. Find Asana in the recommended servers list and click Install.
  3. Under OAuth Client Advanced Settings, paste:
    • Client ID: the Client ID from your Asana app
    • Client Secret: the Client secret from your Asana app
  4. Click Save.

Each team member signs in with their own Asana account on first use, so all tool calls are tied to their individual permissions.

Security considerations​

  • Keep the client secret out of version control and treat it like a password — anyone with it can impersonate your Asana app.
  • Each user authenticates individually with their own Asana account, so agents can only access projects and tasks the user already has permission to view or edit.
  • OAuth tokens issued by Asana's MCP server are MCP-specific and cannot be used with the standard Asana REST API.

Next steps​