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

# Asana MCP server

> Let the Rippit agent find, create, and update Asana work alongside your conversation data.

Connect Asana when customer conversations need to become tracked work. The Rippit agent can look up the tasks and projects related to what customers are saying, check their status, and, if you allow it, create and update tasks from what it finds.

## What the agent gets

* **Tasks and projects**: search, read details, and see comments and activity.
* **Portfolios and status updates**, for a view across projects.
* **People and teams** in your workspace.
* **Tables and records** in Asana tables.
* **Writes**, only if you enable them: create and update tasks and projects (up to 50 tasks at a time), add comments, post project status updates, and delete tasks and table records.

## Setup

In Rippit, open **Connections → MCP Servers**, choose **Asana**, and sign in to Asana. There is no Asana app or token to set up first.

On Asana's consent screen, pick the workspace to connect. Each connection covers one Asana workspace.

If sign-in is refused, an Asana admin may have blocked Rippit under **Admin console → Apps → App Management**. On Enterprise+ plans, admins can allow it there.

## Identity and scope

The connection acts as the Asana user who signed in. Every action appears in Asana as that user, and the agent sees only the workspaces, projects, and tasks that user can see.

An organization-wide connection shares that identity with everyone in your Rippit organization, so sign in with an account whose Asana access suits everyone who will use the agent.

## Write access

The connection starts read-only: tools that create or change Asana work stay off until you enable them under **Tool permissions**.

`delete_task` and `delete_record` delete permanently. `create_tasks` and `update_tasks` change up to 50 tasks in one call.

## Tools

You choose which tools the agent can use under **Tool permissions** on the server's page, one at a time or a whole group at once. See [Setting one up](https://docs.rippit.com/agentic-chat/overview.md#setting-one-up).

Asana adds tools over time, so **Tool permissions** shows the exact list for your connection.

| Tool | Access | What it does |
| - | - | - |
| `search_objects` | Read | Search tasks, projects, portfolios, goals, and other objects by name |
| `search_tasks` | Read | Search tasks with filters. Asana Premium only |
| `get_task`, `get_tasks` | Read | Task details, or tasks in a project, section, or tag |
| `get_task_stories` | Read | A task's comments and activity |
| `get_my_tasks` | Read | The signed-in user's tasks |
| `get_notifications` | Read | The signed-in user's inbox notifications |
| `get_project`, `get_projects` | Read | Project details, or projects in a workspace or team |
| `get_portfolio`, `get_portfolios`, `get_items_for_portfolio` | Read | Portfolios and the projects in them |
| `get_status_overview` | Read | Status updates for projects and portfolios |
| `get_attachments` | Read | Attachments on a task or project |
| `get_me`, `get_user`, `get_users`, `get_teams` | Read | People and teams in the workspace |
| `get_table`, `get_tables`, `get_record`, `get_records`, `search_records` | Read | Asana tables and their records |
| `get_agent`, `get_workspace_agents` | Read | Asana AI Teammates in the workspace |
| `create_tasks`, `update_tasks` | Write | Create or update up to 50 tasks at a time |
| `create_task_from_template` | Write | Create a task from a template |
| `create_project`, `create_project_from_template`, `update_project` | Write | Create or update projects |
| `create_project_status_update` | Write | Post a project status update |
| `add_comment` | Write | Comment on a task |
| `update_notifications` | Write | Mark inbox notifications read or archived |
| `delete_task` | Write | Delete a task permanently |
| `create_table`, `update_table`, `create_records`, `update_records`, `add_record_comment` | Write | Create and update tables and records |
| `delete_record` | Write | Delete a table record permanently |

Which tools start enabled depends on how Asana marks each one, so check **Tool permissions** after connecting and turn off anything you don't want the agent to use.


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