# Asana MCP for AI Agents AI Agent Connect > Asana MCP connects your project management data to your AI agent. It lets you query projects, manage tasks, and inspect board sections directly from any AI client like Claude or Cursor. Instead of jumping between tabs, you can ask your agent to find specific tickets, check who is assigned to what, or update task statuses in real-time. It's the fastest way to keep your team's project tracking and sprint planning synchronized with your actual work. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_HWiPS8Y9Q3XTlxWS876HRXgHMEgGQZnPVRfzT4Cu/ai-agent-connect - **Tags:** task-tracking, sprint-planning, workflow-management, team-collaboration, project-tracking ## Description This Asana MCP connects your project management data to your AI agent. Imagine you're in the middle of a coding session and need to know if the API refactor is finished. Usually, you'd have to leave your IDE, open a browser tab, and hunt through a messy project board to find the right ticket. This changes that. By connecting your Asana account to your AI client, you turn your agent into a project management expert that lives where you work. You can ask about specific task statuses, find out who's blocked on a sprint, or see what's in the "In Progress" column without moving your mouse or losing your train of thought. It handles the heavy lifting of navigating complex hierarchies, so you can stay in your flow. Whether you're a product manager trying to spot stale tickets or an engineer wanting to see task descriptions while you write code, this tool makes the data accessible. It's one of the many high-quality integrations you can find on the Vinkius marketplace to bridge the gap between your data and your AI. You get a direct line to your team's progress, making it easier to stay aligned on what actually needs to happen next. You can pull up project overviews, check assignee details, and manage task comments through a simple conversation. It removes the friction of manual updates and gives you a clear view of the work ahead. ## Tools ### create_task Create a new task in a specific Asana project. Use this to quickly add items as they come up in conversation. ### get_task Fetch the details of a specific task. This helps you see descriptions and status metrics for a single item. ### list_stories View the activity feed for a task. It's great for seeing the history of updates on a specific ticket. ### list_tags See all tags within a workspace. Use this to understand how your team categorizes different types of work. ### get_me Retrieve the details of the current user. This confirms which account the agent is currently using. ### list_projects List all projects in a workspace. This helps you get a high-level view of all active work. ### search_tasks Search for tasks using filters. Use this to find specific items across your entire organizational workspace. ### list_sections List the sections inside a project. This shows you how your board columns and stages are organized. ### list_tasks List all tasks in a project. Use this to get a quick overview of every item in a specific project. ### update_task Update an existing task's details. This lets you change statuses or descriptions via the agent. ### list_workspaces List all workspaces. Use this to see the different environments your account has access to. ### add_task_comment Add a comment to a task. This lets you leave notes or updates on a ticket quickly. ### delete_task Permanently delete a task. Use this to clean up your project board when work is finished. ### get_user Get details for a specific user. This helps you find out who is assigned to what or find team member info. ### list_portfolios List portfolios in a workspace. Use this to see how large groups of projects are organized. ## Prompt Examples **Prompt:** ``` What's the status of the login fix? ``` **Response:** ``` ### Task Status: Login Fix | Task Name | Status | Assignee | | :--- | :--- | :--- | | **Fix Login Bug** | 🟡 In Progress | Marcus R. | | **Update Auth Layer** | 🟢 Completed | Sarah K. | **Notes:** The login fix is currently being tested. Marcus mentioned a small delay with the API response. ``` **Prompt:** ``` Show me what's in the 'In Progress' section of the Mobile App project. ``` **Response:** ``` I've pulled the tasks for the **Mobile App** project currently in the **In Progress** section: * **Refactor API Auth Layer** (Assigned to: David L.) * **Fix Webhook Timeout Payload** (Assigned to: Elena W.) * **Update UI for Login Screen** (Assigned to: Marcus R.) ``` **Prompt:** ``` Who is working on the API migration? ``` **Response:** ``` I found 3 team members currently assigned to tasks related to the **API Migration**: * **David L.** - Working on *Refactor API Auth Layer* * **Elena W.** - Working on *Fix Webhook Timeout Payload* * **Sarah K.** - Completed *Update Auth Layer* ``` ## Capabilities ### Query project tasks Ask your agent to find specific tickets and get their details immediately. ### Inspect board sections See how your sprint is organized across different columns and stages. ### Update task statuses Change the state of a project item through a simple chat command. ### Manage task comments Add notes or updates to specific items without opening the web app. ### Search for specific tasks Filter through your entire workspace to find exactly what you need. ## Use Cases ### Checking requirements while coding A developer wants to see the requirements for a ticket while coding. They ask their agent to fetch the description for a specific task GID. ### Quick sprint status checks A PM needs to know what's in the Testing column. They ask the agent to list sections and then list tasks for that project. ### Cross-client project overviews An agency lead wants to see all active projects for a client. They ask the agent to list workspaces and then list projects. ### Adding rapid updates A team member needs to add a quick update to a task. They tell the agent to add a comment to the task about a minor bug fix. ## Benefits - Stop context switching by checking task statuses directly in your AI client or code editor using get_task. - Quickly identify blockers by using search_tasks to find stale items across multiple projects in seconds. - Keep your sprint board clean by using delete_task and update_task to manage the lifecycle of your work. - Stay updated on team discussions by pulling list_stories to see the latest activity on a specific ticket. - Speed up planning by using list_sections to understand the current workflow structure of any project. - Get immediate access to task metadata and descriptions with get_task to keep your work accurate and visible. ## How It Works The bottom line is you get a way to talk to your Asana data instead of clicking through it. 1. Subscribe to this Connector and get your Personal Access Token from your Asana settings. 2. Paste the token into your AI client's configuration to link your account. 3. Ask your agent to list projects, check task statuses, or update records in real-time. ## Frequently Asked Questions **How does the Asana MCP help my project management?** It allows your AI agent to read and write to your Asana projects. You can ask for status updates, find specific tasks, and manage your board without leaving your current app. **Can I use the Asana MCP to update task statuses?** Yes. You can tell your AI agent to update a task's status, description, or other fields using natural language, and it will sync with Asana automatically. **Does the Asana MCP work with Cursor or Claude?** Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf, giving you project data directly in your editor or chat. **Can my AI agent see who is assigned to a task?** Yes. The Connector allows the agent to retrieve assignee details and user profiles, so you can quickly see who is responsible for what. **Is it easy to set up the Asana MCP?** It is very simple. You just need to subscribe, get your Personal Access Token from Asana, and paste it into your AI client's configuration. **Can I search for tasks across my whole workspace?** Yes. You can ask your agent to find specific tasks using filters across your entire workspace, making it easy to locate old tickets or specific project items. **Can my AI automatically find the details and status of a specific task just by providing the Task GID?** Yes! Use the `get_task` tool with exactly the Task Global ID. Your agent will respond with complete metadata, assignee fields, and precise operational notes connected to that active ticket in seconds. **How do I easily list all the columns in an active agile sprint board?** Simply ask the agent to run the `list_sections` action on the target Project GID. It will compile all column phases (e.g., 'To Do', 'In Progress', 'QA') configured for that environment. **Does the integration permit modifying or deleting my workspace configurations?** No. The core set of tools focuses strictly on heavily querying and analyzing context—listing projects, analyzing metadata, checking tasks. State alteration operations are not currently exposed, assuring your workspaces are secure against destructive queries.