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

# Asana

> Connect Asana to Adapt to analyze projects, tasks, assignees, and due dates

Connect your Asana account to Adapt using a personal access token so Adapt can read your projects and tasks.

## Set up credentials

**1. Open the Asana Developer Console**

Sign in to Asana, then go to [https://app.asana.com/0/my-apps](https://app.asana.com/0/my-apps). You can also reach this page from your profile photo > **My Settings** > **Apps** > **View developer console**.

**2. Create a new token**

Under **Personal access tokens**, click **Create new token**.

**3. Name and agree**

Enter a descriptive token name, check **I agree to the Asana API Terms**, then click **Create token**.

**4. Copy the token**

Copy the token and store it somewhere safe. Asana shows it only once.

> [!NOTE]
>
> If you lose the token, return to the developer console to create a new one and revoke the old one.

## Connect to Adapt

**1. Open Integrations**

In Adapt, go to **Settings > Integrations**.

**2. Find Asana**

Search for **Asana** and select it from the catalog.

**3. Start the connection**

Click **Connect** to open the connection form.

**4. Add your credentials**

Enter the values you gathered above, then click **Add connection**:

| Secret Name | Value |
| - | - |
| `ASANA_ACCESS_TOKEN` | Your personal access token |

You can rename the connection and choose whether it is shared with your
organization or kept personal to you.

**5. Test the connection**

Ask Adapt to list your projects.

### Security

* Credentials are encrypted at rest with AES-256
* The token inherits your Asana permissions, so it can access only the projects and tasks you can see
* Revoke a token anytime from the Asana developer console under Personal access tokens
* Do not share or commit your access token

## Capabilities

Adapt can read your Asana workspace to analyze projects, tasks, assignees, and due dates. Use it to surface status, workload, and timelines across your work.

### Examples

```
Summarize the status of my active Asana projects.
```

```
List all tasks assigned to me that are due this week.
```

```
Which tasks in the Marketing project are overdue?
```

```
Show how tasks are distributed across assignees in the Launch project.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.