# Asana

**Type:** Official

**Source Type:** Remote URL

**Source:** <https://mcp.asana.com/v2/mcp>

**Description:** Asana MCP server provides access to the Asana Work Graph, enabling AI assistants to interact with tasks, projects, workspaces, and comments. It offers 42 powerful tools for task operations including creation, updates, deletion, and search across your entire workspace, along with project and team management capabilities.

**Prerequisites:**

* An Asana account with access to the workspace(s) you want to connect
* A Natoma account with Admin or App Admin permissions

## Setup Steps

### Step 1: Create an OAuth App in Asana

1. Go to the [Asana developer console](https://app.asana.com/0/my-apps) and sign in.
2. Click **Create new app**.
3. Enter a name for your app (e.g., "Natoma MCP Client").
4. Select **MCP app** as the app type.
5. Click **Create app**.
6. Once created, copy your app's **Client ID** and **Client Secret** — you'll need them in Step 4.

### Step 2: Configure Your Redirect URL

1. In the left sidebar of your app, click **OAuth**.
2. Under **Redirect URLs**, add the following Natoma callback URL:

   ```
   https://api.natoma.app/mcp/server/callback
   ```
3. Save your changes.

> **Note:** The redirect URL must match exactly between Asana and Natoma — any mismatch will cause authentication to fail.

### Step 3: Set Workspace Access

1. In the left sidebar, click **Manage distribution**.
2. Under **Distribution method**, choose one of the following:
   * **Specific workspaces** — limits access to selected workspaces (recommended for testing)
   * **Any workspace** — allows use across all Asana workspaces in your organization
3. If you selected **Specific workspaces**, add at least one workspace before saving.
4. Click **Save changes**.

> **Note:** If you choose **Specific workspaces** but don't add any, users will see an error: "This app is not available to your Asana workspace or organization."

### Step 4: Connect Asana to Natoma

1. In Natoma, navigate to **Apps** and find **Asana**.
2. Click the **+** icon next to it.
3. Click **Enable Personal Connections**.
4. A dialog will appear prompting for OAuth credentials. Paste in the **Client ID** and **Client Secret** from Step 1.
5. Click **Continue**.

Admin setup is complete. Users will be able to establish personal connections at this point.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.natoma.ai/apps/asana.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
