Asana MCP. Manage project status and tasks from chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Asana MCP Server gives your AI agent full control over your project workflow. You can list workspaces, query projects, fetch specific tasks and sections, and update task details—all from a natural conversation.
It lets you manage project status, track assignments, and inspect board data without ever opening the Asana app.
What your AI agents can do
Create task
Creates a new task within a specified Asana project.
Get me
Retrieves the current user's profile details from Asana.
Get task
Gets the full details, status, and metadata for one specific Asana task.
The agent can list all organizational workspaces and retrieve all active projects within them.
It allows querying tasks across a project or workspace using specific filters, or fetching details for a single task ID.
The agent can change a task's status, description, or other metadata using the update_task tool.
You can list all board sections and retrieve the activity feed (stories) associated with a specific task.
The agent retrieves your own profile details or lists all available tags across your workspaces.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019d7552create task
Creates a new task within a specified Asana project.
019d7552get me
Retrieves the current user's profile details from Asana.
019d7552get task
Gets the full details, status, and metadata for one specific Asana task.
019d7552list projects
Lists all projects available within a given workspace.
019d7552list sections
Lists the column groupings and stages (sections) inside an Asana project board.
019d7552list stories
Fetches the activity feed (stories) for a specific task.
019d7552list tags
Retrieves a list of all tags used across your Asana workspace.
019d7552list tasks
Lists all tasks belonging to a specific Asana project.
019d7552list workspaces
Retrieves a list of all organizational workspaces connected to your account.
019d7552search tasks
Searches for tasks across a workspace using multiple criteria and filters.
019d7552update task
Modifies the status, description, or other attributes of an existing Asana task.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Asana, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI agent gives you total control over your project workflow in Asana. You can manage everything—from listing workspaces down to updating a single task's status—just by talking to it. It's like having a dedicated project manager sitting right there with you. You never gotta open the Asana app to track progress or change assignments. list_workspaces pulls up all the organizational workspaces you're connected to, and list_projects shows you every active project within them.
You can then use list_sections to list all the column groupings and stages inside a project board, or list_tags to get a rundown of every tag used across your whole workspace. Need to know who you are? get_me pulls up your profile details. To find your work, list_tasks gives you a list of all tasks in a specific project, while search_tasks lets you dig deep, querying tasks across a workspace using multiple filters and criteria.
If you know the exact task, get_task pulls up all the details, status, and metadata for that specific task. You can change things too; update_task lets you modify a task's status, description, or other attributes. To map out the history, list_stories fetches the activity feed for a specific task. For more context, list_stories gives you the activity feed for a specific task.
You can also find out what's going on with a task by calling list_stories.
How Asana MCP Works
- 1 Subscribe to the server and input your Asana Personal Access Token.
- 2 Tell your AI agent the goal (e.g., 'Find all tasks assigned to Marcus in the Marketing project').
- 3 The agent calls the necessary tools (
list_workspaces, thenlist_projects, thenlist_tasks), and you get the resulting data set.
The bottom line is that your AI agent executes multi-step, complex project data retrieval processes that used to require manual navigation through the Asana web interface.
Who Is Asana MCP For?
Product Managers who need real-time project status updates without opening the desktop app. Engineering Leads who need to check task metadata and descriptions straight from their IDE. Operations staff who manage multiple client accounts and need to query cross-functional team progress across different workspaces.
Checks project progress, identifies stale tasks, and inspects sprint board statuses across multiple departments.
Reviews task descriptions and assignee details to ensure code tickets are complete before merging.
Automates the process of querying client workspaces to generate reports on cross-functional team bottlenecks.
What Changes When You Connect
- Track Status Instantly: Instead of opening the Asana app, use the server to check task status and assignee details using
get_taskorsearch_tasks. You get immediate answers in your chat. - See Project Scope: Use
list_workspacesandlist_projectsto map out your entire organization's scope. You can see every active project without clicking through dozens of dashboards. - Build Workflow Chains: Don't just list tasks. Your agent can call
list_sectionsto understand the board stages, then calllist_tasksto find blockers, and finally useupdate_taskto move them. - Eliminate Context Switching: The server lets you query deep metadata (assignees, descriptions) directly from your code editor or chat, keeping your focus on the task at hand.
- Full Visibility: The
list_storiestool fetches the entire activity history for a task. You instantly know who touched it, when, and why, without checking the task's comment section. - Manage User Data: The
get_metool allows your agent to know who you are and what access you have, ensuring that task creation viacreate_taskor updates are scoped correctly.
Real-World Use Cases
Discovering a Missing Dependency
A PM needs to know if a key feature task is stalled. They ask their agent to search_tasks across the 'Engineering' workspace, filtering by 'Feature X' and 'Assignee: Bob'. The agent returns the task ID and the current status, allowing the PM to follow up immediately without manual searches.
Onboarding a New Client Team
An Operations Analyst joins a new client. They ask the agent to list_workspaces. The agent shows the available environments, and the analyst then uses list_projects on the correct environment to get a full view of the client's active work.
Updating a Bug Ticket Status
An Engineering Lead finishes a bug fix. They tell the agent to get_task for the specific bug ID. After confirming the details, they prompt the agent to update_task to mark it as 'Ready for QA'. The status changes instantly without leaving the chat.
Auditing a Project Board
A PM needs to check if the 'Design' section has any tasks assigned to the wrong person. They use list_sections to map the board stages, then use list_tasks to pull all tasks in that section, reviewing the assignee field for compliance.
The Tradeoffs
Searching only by keywords
Typing 'fix api' into the search bar and hoping it shows everything. This only finds tasks with those words, ignoring assignee or status.
→
Use the search_tasks tool. Specify filters like status: pending AND project: API Refactor AND assignee: @user. This ensures you hit the right data.
Forgetting to check dependencies
Attempting to update a task status (update_task) when its dependencies are not met. The task fails, and you don't know why.
→
First, use get_task to fetch the complete metadata, including dependency fields, before running update_task. Verify all fields are correct first.
Manual data copy/pasting
Opening Asana, finding a task ID, copying it, switching to a spreadsheet, and pasting it somewhere else to track it.
→
Just ask the agent to get_task using the task ID. The agent fetches all the data and presents it in a clean, structured format immediately.
When It Fits, When It Doesn't
Use this server if you need to treat your project management platform like a data API. You need to query, filter, and modify project data programmatically, without opening the web UI. This is essential for integrating project status into your code editor or automated scripts.
Don't use this if you just need to visually organize tasks or manage client accounts manually. If you only need to see the general board view, the native Asana UI is faster. However, if you need to check the status of a task and its assignment and its story history in one chat session, this server is what you need. Always prefer using get_task over list_tasks if you know the specific ID, as it gives you deeper metadata.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Asana. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 11 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking project progress shouldn't feel like a rabbit hole of tabs.
Today, figuring out who owns a task requires navigating to the project board, clicking into the task, scrolling to the assignees section, and then checking the comments for status updates. If you have five tasks, you do that five times. It's a cycle of clicking, reading, and copy-pasting IDs.
With the Asana MCP Server, you just ask the agent. You prompt it to `search_tasks` for 'Marketing' and 'Stalled'. The agent executes the search, filters the results, and gives you a clean list with status and assignee, all without you opening the Asana web app. It's instant.
Asana MCP Server: Get full task details with get_task.
Before, checking a task meant clicking into it and reading the limited summary. You saw the title and the current status, but the full description, who was assigned, and the historical comments were hidden or required multiple views.
Now, using `get_task` gives you the full payload. You get the detailed description, the exact assignee, and all the relevant metadata in one go. You don't miss anything.
Common Questions About Asana MCP
How do I use the `list_workspaces` tool with Asana MCP Server? +
You simply ask the agent to list all workspaces. The agent returns a list of all environments you have access to, which you can then use to select the target project for the next step.
Can I check the full history of a task using the `list_stories` tool? +
Yes, the list_stories tool fetches the activity feed. It shows every change and comment related to the task, giving you a complete audit trail.
Does `search_tasks` allow filtering by multiple criteria? +
Yes, search_tasks supports complex filtering. You can specify criteria like status, assignee, and project name in a single query.
What is the difference between `list_tasks` and `search_tasks`? +
list_tasks fetches all tasks in a given project. search_tasks is better for finding tasks across multiple projects or workspaces using specific filters.
How do I use the `get_task` tool to inspect a task's metadata? +
The get_task tool retrieves all metadata for a specific task ID. This includes the full description, who is assigned to it, and its precise status. You can use this to confirm details without navigating the Asana UI.
What is the best way to update a task using the `update_task` tool? +
You must provide the task's unique ID and the exact fields you want to change. The update_task tool overwrites existing data for the specified fields, so be sure to include all necessary parameters.
Does `list_projects` help me find all sections within a workspace? +
No, list_projects only retrieves the main project container. You need to use list_sections after identifying the project's unique GID to see the board column groupings and stages.
Can I use `search_tasks` to find tasks assigned to a specific user? +
Yes, search_tasks accepts assignee filters. You pass the user's email or unique ID as a filter parameter to narrow the results down to tasks owned by that person.
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.
Multi-server workflows that include Asana MCP
Identify Unprofitable Agency Clients Using MCP
Your biggest client generates 28% of revenue but consumes 45% of your team's time , and you will not know they are your least profitable account until you compare project hours against deal value, which nobody does because the data is in 3 different tools
Never Miss a Project Deadline Using MCP
Three deadlines passed last week and nobody noticed because the Asana due dates do not sync to calendars and email reminders go to a folder nobody reads
Ship Design Handoffs Smoothly Using MCP Servers
Design files reviewed, dev tasks created and team notified , one conversation, zero handoff meetings
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Google Classroom
Manage classes, assignments, students, and submissions — automate your Google Classroom workflows via AI.
Instagram (Social Media & Business)
Manage your Instagram presence via AI — publish photos and reels, analyze insights, and manage comments.
SEON
Prevent online fraud with device fingerprinting, email and phone analysis, and real-time risk scoring for digital transactions.
You might also like
EODHD Financial
Access real-time and historical stock market data — prices, fundamentals, dividends, splits and more for global exchanges.
Jokes API (API Ninjas)
Access random jokes — audit content and limits via AI.
Reqres
Test your front-end against a real API — manage users, resources, and project records for prototyping and testing.