> For the complete documentation index, see [llms.txt](https://notara-1.gitbook.io/notara-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://notara-1.gitbook.io/notara-docs/connectors/asana.md).

# Asana

Read Asana projects and tasks — list what's in a project, get full task details, and search across the workspace — directly from Slack.

## What It Enables

| Tool            | Capability | Description                                                  |
| --------------- | ---------- | ------------------------------------------------------------ |
| `list_projects` | `read`     | List all projects in the workspace                           |
| `list_tasks`    | `read`     | List tasks in a project with status, assignee, and due date  |
| `get_task`      | `read`     | Get full task details including subtasks and recent comments |
| `search_tasks`  | `read`     | Search for tasks across the workspace by keyword             |

All tools are read-only. This connector does not create or modify Asana tasks.

## Setup

**Required:** Asana personal access token

**Where to find it:** [app.asana.com → My Settings → Apps → Personal access tokens](https://app.asana.com/0/my-apps)

1. In the Notara dashboard, go to **Tools**.
2. Click the **Asana** tile.
3. In Asana, go to **My Settings → Apps → Personal access tokens** and create a new token.
4. Paste the token into the credential field and click **Verify & Save**.

Your access token is encrypted at rest with AES-256-GCM.

## Example Prompts

> "List all active projects in Asana."

> "What tasks are overdue in the Q3 Launch project?"

> "Search Asana for anything related to onboarding."

> "Show me the details and comments on Asana task 1234567890."