# Asana MCP

> Asana MCP gives your AI agent full control over your project management data. List all workspaces, query active projects, track specific tasks, and inspect complete metadata—all from any compatible client. Use it to manage cross-functional workflows without ever opening the Asana app.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** task-tracking, sprint-planning, workflow-management, team-collaboration, project-tracking

## Description

Connect your organizational Asana account via this MCP, and you'll give your AI agent instant visibility into every project, task, and team workspace. Instead of juggling open browser tabs, you talk to your agent about your work. You can list all active workspaces or fetch specific projects by name. Need to know what's happening on a sprint board? Your agent lists the sections and tells you exactly what stage a feature is in. If you need details on one task, it pulls everything—description, assignees, status, even activity feed stories. This capability lets your AI act like an embedded project manager. When you connect this MCP through Vinkius, you get access to Asana's full suite of tools directly inside your agent interface, making complex operations feel natural and conversational.

## Tools

### create_task
Creates a brand new task within a specified Asana project.

### get_task
Retrieves all detailed information for one specific existing Asana task.

### list_stories
Pulls the activity feed, or 'story,' for a given task to see recent comments and updates.

### list_tags
Lists all unique tags used across the entire workspace structure.

### get_me
Retrieves the profile details of the user connected to your AI agent.

### list_projects
Provides a list of all projects contained within a specific workspace.

### search_tasks
Searches for tasks across the workspace using multiple filtering criteria like due date or assignee.

### list_sections
Lists all column groupings, or sections, that make up a particular project board.

### list_tasks
Generates a list of all tasks within an entire Asana project.

### update_task
Modifies the status, description, or assignee for an existing task.

### list_workspaces
Lists every top-level organizational workspace associated with your account.

### add_task_comment
Adds a new comment to an existing task for team communication.

### delete_task
Permanently removes a specified Asana task from the workspace.

### get_user
Fetches detailed profile information for a specific user by their name or ID.

### list_portfolios
Retrieves a list of project portfolios used across the workspace.

## Prompt Examples

**Prompt:** 
```
List all our active organizational workspaces on Asana.
```

**Response:** 
```
I've fetched your environments. You currently have access to two distinct environments: 'TechCorp Engineering' (GID: 1205934) and 'Marketing Campaigns' (GID: 593021). Which workspace would you like to drill into?
```

**Prompt:** 
```
Can you fetch the tasks pending inside project 1205934?
```

**Response:** 
```
Running the query logic... I found 5 active task GIDs inside that specific project. Notable recent tickets include 'Refactor API Auth Layer' and 'Fix Webhook Timeout Payload'. Would you like the full description of 'Fix Webhook Timeout Payload'?
```

**Prompt:** 
```
Provide the complete details and assignee for task GID 12039402123.
```

**Response:** 
```
Let's inspect it... Task 'Implement Rate Limiting' has the detailed description: 'Need to add Redis throttle to 50 reqs/sec as discussed'. The current status is mapped to 'In Progress' and is specifically assigned to 'Marcus R.'.
```

## Capabilities

### List all organizational workspaces
Retrieves a list of every workspace the connected account has access to.

### Fetch project lists and sections
Lists active projects within a workspace or breaks down a project into its component board sections.

### Query specific tasks
Searches for, retrieves details on, or updates individual tasks using filters or unique identifiers.

### Manage user data and profiles
Retrieves the profile information and credentials of specific users within your organization.

## Use Cases

### Finding who owns a blocked feature
A PM needs to know why the API integration task is stalled. They ask their agent to 'search for tasks' related to 'API Integration.' The agent finds the ticket, checks its metadata, and reports that it’s assigned to John Doe, who hasn't updated it in a week.

### Onboarding a new team member
An Operations Lead needs an overview of all client projects. They ask the agent to 'list workspaces,' get the list, and then request 'list_projects' for each one, building a comprehensive status report instantly.

### Updating project requirements
An Engineering Lead finishes writing acceptance criteria. Instead of opening Asana, they use 'update_task' through their agent to modify the description and change the task status from Draft to Ready for Review.

### Getting a full history on a client request
A Project Manager needs context on an old bug report. They ask the agent to 'list_stories' for that specific task, and the tool pulls all historical comments and status changes in one readable feed.

## Benefits

- Instantly check task status. Instead of opening the app to see if a task is stalled, your agent runs a query and tells you exactly who owns it and where it stands.
- Eliminate deep dives. Use 'get_task' or 'get_user' to pull all necessary metadata—like assignee and description details—in one single pass, saving minutes on every ticket.
- Keep documentation clean. You can use 'add_task_comment' directly through your agent when collaborating with teammates, keeping the conversation tied right where the work is happening.
- Map out workflows quickly. List all board sections ('list_sections') to understand how a project moves from ideation to completion without navigating multiple boards.
- Handle large datasets efficiently. Use 'search_tasks' to filter thousands of records by criteria like due date or assignee, giving you an instant report.

## How It Works

The bottom line is you use plain conversation instead of clicking through multiple Asana pages to find what you need.

1. Subscribe to this MCP on Vinkius and enter your Asana Personal Access Token.
2. Give permission for your AI client to access your desired workspaces and projects.
3. Ask your agent a natural language question, like 'List all tasks assigned to Marcus in the Q3 project,' and get the data back.

## Frequently Asked Questions

**How do I list all my available Asana workspaces using the Asana MCP?**
You use 'list_workspaces' to get a master roster of every organizational workspace you have access to. This is the starting point for any large-scale audit or cross-departmental query.

**Can I update tasks without opening Asana? (Asana MCP)**
Yes, you can use 'update_task' directly through your agent. You just need to provide the task ID and what change you want—like changing the status or adding a new assignee.

**What is the best way to check task history with Asana MCP?**
The 'list_stories' tool pulls the activity feed for any given task. This shows all comments, updates, and changes over time, giving you a complete audit trail.

**Does the Asana MCP let me create tasks? (Asana MCP)**
Yes, you can use 'create_task' to generate new work items directly within your project. It’s useful when an idea comes up during a meeting and needs immediate tracking.

**Can I find all tasks for a specific assignee? (Asana MCP)**
You use 'search_tasks' to filter by the assignee field along with other criteria. This is much more powerful than just listing projects, as it gives you targeted results.