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

# Asana

> Tasks, projects and sections. Team workload — it says what people are doing, not what a page should say.

Tasks, projects and sections. Team workload — it says what people are doing, not what a page should say.

## Connecting

In the dashboard, open **Connectors**, find Asana and press **Connect**. You will be sent to sign in; the connection is saved once that succeeds.

### What you will need

| Field | What it is |
| - | - |
| Client ID | Your Asana OAuth app Client ID (for OAuth 2.0) |
| Client Secret | Your Asana OAuth app Client Secret (for OAuth 2.0) |
| Personal Access Token | Your Asana Personal Access Token (for personal integrations) |

### Getting the credential

For personal use, generate a Personal Access Token in Asana Settings > Apps > Developer Apps. For OAuth apps, create an app at [https://app.asana.com/0/developer-console](https://app.asana.com/0/developer-console) and get Client ID/Secret.

## Notes

* A Personal Access Token is the quickest way in and is what this connector expects; OAuth apps are for
  multi-user products and are not needed here.
* Most tools take Asana's numeric GIDs rather than names — `get_workspaces` and `get_projects` are how you find them.

## What your AI teammate can do with it

| Tool | What it does |
| - | - |
| `get_workspaces` | Get all workspaces the user has access to |
| `get_me` | Get current user information |
| `get_projects` | Get projects in a workspace |
| `get_project` | Get a specific project by GID |
| `create_project` | Create a new project |
| `update_project` | Update an existing project |
| `get_tasks` | Get tasks in a project |
| `get_task` | Get a specific task by GID |
| `create_task` | Create a new task |
| `update_task` | Update an existing task |
| `delete_task` | Delete a task |
| `add_task_to_project` | Add a task to a project |
| `get_subtasks` | Get subtasks of a task |
| `create_subtask` | Create a subtask |
| `get_sections` | Get sections in a project |
| `create_section` | Create a section in a project |
| `get_teams` | Get teams in a workspace |
| `get_team_users` | Get users in a team |
| `search_tasks` | Search for tasks in workspace |
| `get_tags` | Get tags in a workspace |
| `create_tag` | Create a tag in a workspace |
| `get_attachments` | Get attachments for a task |
| `get_stories` | Get activity/stories for a task |
| `create_story` | Create a comment/story on a task |
| `get_custom_fields` | Get custom fields in a workspace |
| `create_custom_field` | Create a custom field in a workspace |
| `get_portfolios` | Get portfolios in a workspace |
| `create_portfolio` | Create a new portfolio |
| `add_project_to_portfolio` | Add a project to a portfolio |

## Useful resources

* [Asana documentation](https://developers.asana.com/docs/authentication)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.