> ## Documentation Index
> Fetch the complete documentation index at: https://dev.writer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana connector

> Connect WRITER Agent to Asana for workspaces, tasks, projects, and workload insights

This guide shows you how to configure the [Asana](https://asana.com/) 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](https://app.writer.com/aistudio) under **Connectors & Tools**.

<Note>
  The Asana connector only supports organization-managed OAuth. You must create your own Asana OAuth app. Writer-managed OAuth is not available for Asana.
</Note>

### Create an Asana OAuth application

Create an MCP app in the Asana developer console:

1. Navigate to the [Asana developer console](https://app.asana.com/0/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:
   ```
   https://app.writer.com/mcp/oauth/callback
   ```
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](#configure-the-connector-in-ai-studio)

For more information, see [Integrating with Asana's MCP Server](https://developers.asana.com/docs/integrating-with-asanas-mcp-server) documentation.

### Configure the connector in AI Studio

1. Navigate to **Connectors & Tools** in [AI Studio](https://app.writer.com/aistudio)
2. Select the Asana connector
3. Select who has access by default (all users or specific teams)
4. Select the connection level: user level (each user authenticates their own account) or org level (shared connection to a single account)
5. Select which tools to enable for your agents
6. Enter your OAuth client ID and client secret
7. Complete the OAuth authorization flow

## Next steps

* [Set up connectors](https://support.writer.com/article/299-setting-up-connectors): Learn how to configure and enable connectors in AI Studio
* [Tool calling guide](/home/tool-calling): Understand how AI agents use tools in conversations
* [WRITER Agent guide](https://support.writer.com/article/293-how-to-use-action-agent): Learn how to use WRITER Agent with connected tools
* [MCP gateway overview](/home/mcp-gateway): Learn about Writer's MCP gateway architecture