Skip to main content
This guide shows you how to configure the Asana connector for WRITER Agent. After setting up this connector, WRITER Agent can access workspaces and team members, create, read, update, and delete tasks and subtasks, and retrieve task details, comments, dependencies, and project structure—enabling AI-driven task creation, project summaries, and workload insights.

​
Set up the Asana connector

Configure the Asana connector in AI Studio under Connectors & Tools. The Asana connector supports two authentication options:
  • WRITER-managed OAuth (recommended): Writer provides the OAuth application. No setup required - just authorize access to your Asana workspace.
  • Organization-managed OAuth: Create your own Asana OAuth application for custom branding and control.
Most users should choose WRITER-managed OAuth for faster setup. Only use organization-managed OAuth if you need custom branding or have specific security requirements.

​
Create an Asana OAuth application (organization-managed only)

If you choose to create a self-managed OAuth application to connect, create an MCP app in the Asana developer console:
  1. Navigate to the Asana developer console and sign in
  2. Select Create new app
  3. Enter your app name (for example, “My MCP Client”)
  4. Select MCP app as the app type
  5. Select Create app
  6. In the left sidebar, select OAuth and add the Writer redirect URI to Redirect URLs:
    If your organization is deployed in the EU, use https://app.eu2.writer.com/mcp/oauth/callback instead.
  7. In the left sidebar, select Manage distribution. Under Distribution method, choose Specific workspaces (and add at least one workspace) or Any workspace, then select Save changes
  8. Navigate to Basic information and copy the Client ID and Client secret for use in AI Studio
For more information, see Integrating with Asana’s MCP Server documentation.

​
Configure the connector in AI Studio

  1. Navigate to Connectors & Tools in AI Studio
  2. Select the Asana connector
  3. Select who has access by default (all users or specific teams)
  4. Select the connection type:
    • Level: User level (each user authenticates their own account) or org level (shared connection to a single account)
    • Managed by: WRITER-managed or self-managed (your own OAuth app)
  5. Select which tools to enable for your agents
  6. Enter your OAuth client ID and client secret (if using self-managed OAuth)
  7. Complete the OAuth authorization flow

​
Next steps