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

# Asana

The Asana integration syncs tasks from your Asana projects into Mains's entity store. Tasks become searchable locally and available as context in AI chat.

## **Authentication**

Asana uses **OAuth** for authentication. Mains will open a browser window to authorize access to your Asana account.

## **Setup**

<Steps>
  <Step title="Connect Asana">
    Go to **Settings > Connections** and click **Connect** next to Asana. Authorize Mains through the Asana OAuth flow.
  </Step>

  <Step title="Select Projects">
    Choose which Asana projects to sync. Only tasks from selected projects will be fetched.
  </Step>

  <Step title="Initial Sync">
    Mains fetches existing tasks and then syncs incrementally on subsequent runs.
  </Step>
</Steps>