> ## Documentation Index
> Fetch the complete documentation index at: https://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

<Steps>
  <Step title="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**.
  </Step>

  <Step title="Create a new token">
    Under **Personal access tokens**, click **Create new token**.
  </Step>

  <Step title="Name and agree">
    Enter a descriptive token name, check **I agree to the Asana API Terms**, then click **Create token**.
  </Step>

  <Step title="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.</Note>
  </Step>
</Steps>

## Connect to Adapt

<Steps>
  <Step title="Open Integrations">
    In Adapt, go to **Settings > Integrations**.
  </Step>

  <Step title="Find Asana">
    Search for **Asana** and select it from the catalog.
  </Step>

  <Step title="Start the connection">
    Click **Connect** to open the connection form.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Test the connection">
    Ask Adapt to list your projects.
  </Step>
</Steps>

### 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.
```