> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Asana Agent Connector
> Connect your Agent to Asana to look up and manage tasks, projects, and subtasks in real time.
The Asana Connector gives your [Agents](/agents/overview) live access to your Asana workspace. Agents can search for tasks, read project data, create new tasks, add comments, and more — directly during a conversation. Data is accessed in real time and never copied or stored in Cassidy.
For best results with complex Connector queries, use a powerful, reasoning-capable model. Cassidy supports models from OpenAI, Anthropic, and Google — see [Choose the right AI model](/guides/choose-ai-model) for current recommendations.
## Set up the Asana Connector
Go to **Agents** and select the Agent you want to configure.
Click the **Setup** tab and scroll to the **Connectors** section.
Click **+ Add Connector** and select **Asana**.
Select how users will authenticate:
* **Each user connects their own account** (recommended) — each user signs in with their own Asana credentials the first time they use the Connector
* **Use a shared Asana connection** — all users access Asana through one shared account
If using a shared connection, select an existing Asana connection from your organization or click **Set up shared connection** and sign in to authorize access.
Optionally share the connection with other team members or make it available to your entire organization.
Set the permission level for each action the Agent can perform:
* **Always Allow** — The Agent performs the action automatically when needed
* **Needs Approval** — The Agent asks the user for permission before taking the action
* **Disabled** — The Agent cannot perform the action
Asana tools are organized into three groups:
* **View Data** — Read-only actions like getting tasks, searching the workspace, and reading project details. Defaults to **Always Allow**.
* **Create & Modify** — Write actions like creating tasks, updating tasks, adding comments, and creating subtasks. Defaults to **Disabled**.
* **Remove Data** — Destructive actions like deleting tasks or removing tasks from projects. Defaults to **Disabled**.
Review Create & Modify and Remove Data permissions carefully — **Always Allow** lets the Agent create, update, or delete tasks without asking first.
Click **Add Tool** to enable the Connector for this Agent.
## Monitor Asana actions
When an Agent uses the Asana Connector during a conversation, you can review what happened by expanding the action steps shown in the response. Each step shows which Asana action was called and what the Agent was thinking at each point.
Click any action step to see the full input and output — including which action was called and the data returned from Asana.
## What the Agent can do
Once connected, your Agent can help with Asana tasks including:
* Looking up tasks by name or searching across your workspace
* Reading task details, due dates, and assignees
* Getting all tasks in a project
* Creating new tasks and subtasks
* Updating existing tasks
* Adding comments to tasks
* Adding followers to tasks
* Reading time tracking entries
* Deleting tasks
## Data security
Asana data is accessed in real time and is not copied or stored in Cassidy. The Agent only queries Asana when needed to answer a question or complete a task.
## Next steps
Learn about all available Agent Connectors and how they work.
See every integration available in Cassidy.