# Asana

<div style={{maxWidth: '720px'}}>
![The Asana connector in Workspace Settings, for searching, creating, and updating tasks and projects, with a Connect button](</docs/_next/static/media/asana-connector.2ddf_to2wy4-x.jpg>)
</div>

The [Asana MCP server](https://developers.asana.com/docs/using-asanas-mcp-server) lets agents work directly in your Asana workspace, so they can read the task behind a ticket, file follow-up work, and keep everyone up to date while they work.

For use cases and example prompts, see [Asana for AI coding agents](/integrations/asana).

## What is Asana? [#what-is-asana]

[Asana](https://asana.com) is a work management tool that teams use to plan and track tasks, projects, and goals.

## What agents can do [#what-agents-can-do]

Once you connect Asana, agents can:

- Search for tasks, projects, and people, and read a task's details, subtasks, and comments
- Create tasks and subtasks with an assignee and due date, and update or delete them
- Comment on tasks
- Create and update projects, and post project status updates

Agents can only see and change what your Asana account can, in the one Asana workspace chosen when you sign in. To switch workspaces, disconnect and connect again.

<Callout>
Agents can delete tasks, and the tasks, comments, and status updates they create show up right away under the signed-in person's name. Tell agents when they should only read.
</Callout>

## Setup [#setup]

Asana connects by signing in with your Asana account. There's no API key to create, and its MCP server doesn't accept Asana personal access tokens.

Go to **Workspace Settings → Connectors** (or a project's **Connectors** page) and click **Connect** on the Asana card (or **Connect another** to add another account).

### Step 1: who the connection is for [#step-1-who-the-connection-is-for]

Choose **Me** or **Workspace** as the owner, then choose which agents can use the connection. The default is **Me**, with **My personal assistants** selected. Enable **Agents in projects** separately and choose **In all projects, including future ones** or **In some projects**. Anyone with access to those projects can use the connection, including in sessions they launch themselves. See [connection options](/docs/integrations/connectors#fill-in-the-connection-details) for what each choice means.

Click **Continue**.

### Step 2: sign in with Asana [#step-2-sign-in-with-asana]

Click **Continue to Asana**. Asana asks you to sign in and approve access. If your account is in more than one workspace, pick one from the menu at the top of Asana's approval screen. Approve, and you land back on the Connectors page with **Asana connected**.

Agents then act in Asana as whoever signed in, so they see exactly what that person can. If you enable **Agents in projects**, anyone with access to those projects can use that account — so sign in with an account whose permissions you're happy to share.

## Reconnecting and disconnecting [#reconnecting-and-disconnecting]

If an account connection stops working, the Connectors page shows a **Reconnect needed** badge on it, and agents run without Asana.

To fix it, click **Manage** next to the connection, then **Reconnect Asana**, and sign in again. You can only reconnect a personal connection you own; for someone else's, Superconductor tells you who to ask.

**Disconnect** also revokes Superconductor's access at Asana. If Asana doesn't confirm the revocation, Superconductor tells you to remove Superconductor from the Authorized integrations section of your Asana settings to finish the job.

## When to use it [#when-to-use-it]

Ask agents to use Asana when a ticket starts from an Asana task, or when the work should leave a trail there. For example:

```text
Read the "Q3 launch announcement" task in Asana and draft the blog post it describes. Comment on the task with a link to the draft when you're done.
```

```text
Go through the open tasks in our Website Refresh project in Asana and write a short status report: what's done, what's overdue, and who owns each blocker.
```

```text
Turn the action items from this week's planning notes into Asana tasks in the Operations project, each with an owner and a due date.
```

```text
Find the Asana task about the broken password reset email, fix it in this repo, and comment on the task with what changed.
```