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

# Asana

> Create tasks, manage projects, and track work in Asana — plan and coordinate directly from Mantle conversations

Connect Asana to let selected agents create tasks, manage projects, and work with the teams and projects your connected
account can access.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Task management" icon="list-check">
    Create, update, assign, and search tasks across projects — directly from chat or through an agent.
  </Card>

  <Card title="Project tracking" icon="chart-gantt">
    Manage projects, sections, and milestones. Duplicate projects, update statuses, and track progress.
  </Card>

  <Card title="Team coordination" icon="users">
    View teams, manage memberships, and track workloads available to the connected account.
  </Card>

  <Card title="Custom fields & goals" icon="bullseye">
    Work with custom fields, goals, portfolios, and tags to organize work the way your team needs.
  </Card>
</CardGroup>

***

## Connect Asana

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Asana**.
  </Step>

  <Step title="Authorize with OAuth">
    Click **Connect** and sign in to your Asana account. Grant Mantle the requested permissions to access your work
    data.
  </Step>

  <Step title="Confirm the connection">
    Once authorized, you'll be redirected back to Mantle. The integration status will show as connected.
  </Step>
</Steps>

***

## Agent tools

Add Asana tools to agents that need them. Their access is limited by the connected account and selected tools.

### Tasks

| Tool           | Description                                             |
| -------------- | ------------------------------------------------------- |
| Create task    | Create a new task with title, description, and assignee |
| Get task       | Retrieve full details of a task                         |
| Update task    | Edit task fields like name, due date, or status         |
| Search tasks   | Search tasks in a workspace by keyword or filters       |
| Create subtask | Add a subtask under a parent task                       |
| Add to section | Move a task into a specific project section             |
| Add comment    | Post a comment on a task                                |

### Projects & Sections

| Tool               | Description                                 |
| ------------------ | ------------------------------------------- |
| Create project     | Create a new project in a team or workspace |
| Get project        | Retrieve project details and configuration  |
| List projects      | List all projects with optional filters     |
| Create section     | Add a new section to a project              |
| Get project status | Check the latest status update on a project |

### Teams & Users

| Tool             | Description                          |
| ---------------- | ------------------------------------ |
| Get team         | Retrieve team details                |
| List teams       | List teams in a workspace            |
| Get user         | Retrieve a user's profile            |
| List users       | List users in a workspace or team    |
| Get current user | Get the authenticated user's profile |

### Custom Fields & Tags

| Tool                | Description                               |
| ------------------- | ----------------------------------------- |
| Create custom field | Create a new custom field for a workspace |
| Get custom field    | Retrieve custom field details and options |
| Create tag          | Create a new tag for organizing tasks     |
| Get goals           | List goals and track progress             |

***

## Triggers

<Note>
  Automated triggers for Asana are not yet available. Triggers will be added in a future update — check back soon.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Turn chat action items into Asana tasks">
    After a discussion, ask your agent to create tasks for each action item — it sets the title, assignee, due date, and
    project section based on the conversation context.
  </Accordion>

  <Accordion title="Weekly project status report">
    An agent searches for tasks completed this week, groups them by project, and posts a progress summary to your team
    channel — no manual reporting needed.
  </Accordion>

  <Accordion title="Track blocked tasks across projects">
    Ask your agent "What tasks are blocked?" and it searches across all projects for tasks marked as blocked or overdue,
    then lists them with assignees and due dates.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth connection failed">
    Make sure you are signing in with an Asana account that has access to the workspace you want to connect. If the
    connection fails, try disconnecting and reconnecting from **Settings → Integrations → Asana**.
  </Accordion>

  <Accordion title="Agent can't find my project">
    The connected account must be a member of the project. Check your Asana project membership and ensure the
    authenticating user has access.
  </Accordion>

  <Accordion title="Task creation fails with missing fields">
    Asana requires a workspace for task creation. Make sure the agent specifies the workspace or project when creating
    tasks. Use "List projects" to find valid project IDs.
  </Accordion>

  <Accordion title="Custom fields aren't showing">
    Custom fields are workspace-scoped. Verify the connected user has access to the workspace where the custom fields
    are defined.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>