Asana MCP server: connect Asana to Claude, ChatGPT and Cursor
Lets Claude, ChatGPT or Cursor find, create and update your Asana tasks and projects. You sign in with your Asana account, with nothing to install.
This is Asana's official way to connect your AI assistant to Asana, and Asana runs it for you. You can ask it to find your tasks, create and update tasks and projects, add comments and post status updates. It works inside one Asana workspace at a time and can do anything your account can, with no read-only option. In Claude and ChatGPT you just turn on the Asana app, but coding tools such as Claude Code, Cursor and VS Code first need you to register a free app in Asana's developer console.
Good for
- Teams who plan in Claude or ChatGPT and want the plan to land in Asana as real projects and tasks
- People who want a quick answer to what is due this week or how a project is going
- Developers who track work in Asana and code with Claude Code, Cursor, VS Code or Codex
- Enterprise+ admins who want to choose which AI apps can reach the workspace
Works in
7 supported · 6 should work
Tap an app to see how to set it up and any known problems.
Asana's guide adds it with claude mcp add, your Asana app's client ID and secret, and a fixed callback port.
Known problems
- Fixed
Creating tasks failed after the first one in a project
Reported Apr 2026 · forum.asana.com
- Closed
Sign-in rejected because the callback address did not match the Asana app
Workaround: Connect Asana in claude.ai settings first, or register the callback port Asana's guide uses.
Reported Apr 2026 · forum.asana.com
Asana is in Claude's connector directory: connect it there and sign in, or ask your admin to turn it on.
Known problems
- Closed
Task lists can show as a visual widget that Claude itself cannot read
Workaround: Asana staff suggested asking Claude for raw text only.
Reported Jul 2026 · forum.asana.com
- Closed
New tasks went through a preview step that could not pick an existing project
Reported Mar 2026 · forum.asana.com
Asana's guide adds the URL with your client ID and secret in Cursor's MCP settings, then you click Connect. developers.asana.com
Asana's guide uses MCP: Add Server, then VS Code asks for your client ID and secret. developers.asana.com
Asana's guide connects Windsurf through the community mcp-remote bridge using your client ID and secret. developers.asana.com
Asana's guide connects Codex through a community bridge called mcp-remote, with your app's keys in a private file.
Known problems
- Fixed
Creating tasks failed after the first one in a project
Reported May 2026 · forum.asana.com
Asana has an app in ChatGPT: connect it from ChatGPT and sign in to Asana. help.asana.com
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Asana says JetBrains cannot yet do the sign-in setup the current server needs. developers.asana.com
Install Asana MCP
Claude Code
- 1
Copy this prompt.
Add the Asana MCP server to Claude Code. Run this command: claude mcp add --transport http \ --client-id YOUR_CLIENT_ID \ --client-secret \ --callback-port 8080 \ asana https://mcp.asana.com/v2/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Asana MCP app client ID and secret (developer console).
Read-only mode: There's no read-only mode. Set your app to ask you before it creates, changes or deletes anything in Asana.
First create an MCP app in Asana's developer console, add your workspace under Manage distribution, and copy its client ID and secret. Set its redirect URL to http://localhost:8080/callback. Claude Code then asks for the client secret and stores it in your system keychain, and opens your browser to sign in. If you already connected Asana on claude.ai, it can also show up in Claude Code without these steps.
From the vendor's docs. Source.
Tools
Lists the tasks assigned to you, open or done
Shows the tasks assigned to you, and can limit them to open tasks or tasks finished since a date.
Try: “What tasks do I have that are still open?”
Network ·
get_my_tasksFinds tasks, projects, people, goals and teams by name
Looks up tasks, projects, templates, portfolios, goals, teams, people, tags, custom fields and AI Teammates by name. It is usually the first step when the assistant does not know where something is.
Try: “Find the onboarding project template”
Network ·
search_objectsLists tasks in a project, section, tag or for a person
Lists tasks in a project, section, tag or a person's task list, and can filter by when they were changed or finished.
Try: “List all incomplete tasks in the Marketing project”
Network ·
get_tasksSearches task names, descriptions and comments with filters
Does a full-text search across task names, descriptions and comments, filtered by assignee, dates, project, section, tag or custom fields. Asana documents it as Premium only.
Try: “Find all overdue tasks assigned to me”
Network ·
search_tasksShows a task's full details, comments and subtasks
Shows one task's assignee, dates, custom fields, projects, dependencies, followers and sections, plus its comments and subtasks.
Try: “What are the subtasks on the Website Redesign task?”
Network ·
get_taskShows the activity history and comments on tasks
Shows the activity feed for one or several tasks: comments plus changes such as new assignees, completion and date changes.
Try: “What changed on this task this week?”
Network ·
get_task_storiesSummarizes the status of projects or portfolios
Builds a status report for matching projects or portfolios, with their latest status updates, task summaries and flagged blockers.
Try: “Give me a status overview of the Rebrand initiative”
Network ·
get_status_overviewShows a project's owner, members, status and sections
Shows a project's owner, members, current status, task counts and, if asked, its sections.
Try: “What sections does the Sprint 12 project have?”
Network ·
get_projectLists projects in the workspace or a team
Lists projects in the workspace, optionally only one team's or only archived or active ones, with task counts.
Try: “List all active projects for the Engineering team”
Network ·
get_projectsLists the portfolios you own
Lists the portfolios you own in the current workspace.
Try: “What portfolios do I own?”
Network ·
get_portfoliosShows the details of a portfolio
Shows the details of one portfolio, such as its name, owner and fields.
Try: “Show me the details of the Q4 portfolio”
Network ·
get_portfolioLists the projects and goals inside a portfolio
Lists what a portfolio holds, such as its projects and goals.
Try: “What projects are in the Company Goals portfolio?”
Network ·
get_items_for_portfolioShows what is waiting in your Asana Inbox
Lists your Asana Inbox notifications, who triggered them and what they are about. Only available when Asana has turned on notification tools for your session.
Try: “What needs my attention in my Asana Inbox?”
Network ·
get_notificationsLists files attached to a task or project
Lists files attached to a task, project or project brief, with links to view or download them.
Try: “What files are attached to the Design Spec project?”
Network ·
get_attachmentsLists people in the workspace or a team
Lists people in the workspace, or only members of one team, with their names and emails.
Try: “Who is on the Engineering team?”
Network ·
get_usersLists the teams in the workspace
Lists the teams in the workspace, or only the teams one person belongs to.
Try: “List all teams in the workspace”
Network ·
get_teamsLooks up a person by their Asana ID or email
Shows a person's name, email and workspaces, looked up by ID or email.
Try: “Who is jane@example.com in Asana?”
Network ·
get_userLists the AI Teammates set up in the workspace
Lists the Asana AI Teammates configured in your workspace. People are listed separately.
Try: “What AI Teammates are set up in this workspace?”
Network ·
get_workspace_agentsShows what one AI Teammate is set up to do
Shows one AI Teammate's name, description and the guidance it follows.
Try: “What does the Triage Bot AI Teammate do?”
Network ·
get_agentCreates one or more tasks right away, up to 50 at once
Creates tasks immediately, up to 50 in one go, with assignees, dates, sections, descriptions, followers and custom fields. It reports which ones failed.
Try: “Create tasks for each item in this list in the Launch project”
Write ·
create_tasksChanges tasks: assignee, dates, status, project and more
Changes up to 50 tasks at once: names, assignees, dates, descriptions, completion, parent task, dependencies, projects, followers and custom fields. Some changes can apply even when others fail.
Try: “Mark these tasks as complete”
Write ·
update_tasksAdds a comment to a task
Posts a comment on a task, with mentions and the option to pin it.
Try: “Add a comment saying the design files are ready for review”
Write ·
add_commentCreates a new project with sections and tasks
Creates a project right away, optionally with sections and tasks inside them. If you do not name a team, Asana picks one.
Try: “Set up a project for the Q4 launch with Backlog and In Progress sections”
Write ·
create_projectChanges a project's details, sections, members or access
Changes a project's details, dates, owner, look, privacy, archive state, sections, members and custom fields. Adding members or opening up access asks for your confirmation first.
Try: “Archive the completed launch project”
Write ·
update_projectPosts a status update on a project or portfolio
Posts a status update with a title, a color such as green, yellow or red, and text to a project or portfolio.
Try: “Post a green status update to the Q3 Roadmap project saying we are on track”
Write ·
create_project_status_updateCreates a task from one of a project's task templates
Lists a project's task templates, or creates a task from one by name. The task appears shortly after.
Try: “Create a task from the Bug Report template”
Write ·
create_task_from_templateCreates a project from a project template
Starts a new project from a project template, with a name, team, privacy, dates and role assignments. The project appears shortly after.
Try: “Create an onboarding project from our standard template”
Write ·
create_project_from_templateMarks Inbox notifications as read or unread
Marks your Asana Inbox notifications as read or unread. Only available when Asana has turned on notification tools for your session.
Try: “Mark these notifications as read”
Write ·
update_notificationsDeletes a task and its subtasks
Deletes a task, along with any subtasks that are not also in another project.
Try: “Delete this duplicate task”
Delete ·
delete_taskShows matching tasks as a clickable list in the chat
Searches tasks by text, assignee, project, dates or status and shows the results as an interactive list, in apps that support it.
Try: “Show me a visual list of tasks due this week”
Network ·
search_tasks_previewDrafts a task for you to review before it is created
Drafts a task, with subtasks and a description, and shows it for you to check and edit before it goes into Asana. Only in apps that support interactive views.
Try: “Let me review a follow-up task before creating it”
Write ·
create_task_previewDrafts a project plan for you to review before it is created
Drafts a project with sections and tasks and shows it for you to approve or edit before it is created. Only in apps that support interactive views.
Try: “Preview a project plan for our Q4 launch”
Write ·
create_project_previewUsed by the assistant behind the scenes
Checks which Asana account is signed in
Returns the name, email and workspaces of the signed-in account, so the assistant knows who you are.
Try: “Which Asana account am I signed in as?”
Network ·
get_me
From the official docs
Pros and cons
Good
- Built and run by Asana, with nothing to install or host
- Built-in Asana apps in Claude and ChatGPT need no keys or setup files
- Covers tasks, projects, portfolios, comments, status updates and templates
- Only reaches what your Asana account can already see, and actions show up under your name
- Asks before sharing a project or opening up its access
- Enterprise+ admins can allow or block each AI app
Watch out
- No read-only mode or per-project limit
- One workspace per connection
- Coding tools need you to register an Asana app and copy a client ID and secret
- Codex, Windsurf and Kiro need a community bridge that Asana does not support
- JetBrains cannot connect to the current server yet
- Advanced task search is documented as Premium only
Permissions
medium risk · 7 things to watch
Medium risk
Your assistant can create, change and delete tasks and projects anywhere your Asana account can, and there is no way to limit it to reading. Turn on your AI app's setting that asks you before it makes changes, and sign in with an account that only reaches the projects you need.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can delete tasks, not just read them
Deleting a task also removes subtasks that are not in another project. Keep your AI app's approval prompt on for changes. developers.asana.com
No read-only option: it can do what you can
Every sign-in gets all tools. Use an Asana account that only reaches the projects you want the assistant to touch. developers.asana.com
A 2025 bug could show data to other companies
In June 2025 Asana took its first version offline for about two weeks after a bug could expose some data to other Asana MCP users; Asana reported no sign it was misused. The current server is a newer version. theregister.com
Bulk edits can partly succeed
A batch of task or project changes can apply some edits and fail others. Check the result before asking it to try again, so changes are not repeated. developers.asana.com
Codex and Windsurf rely on an unsupported bridge
Asana's guide uses the community mcp-remote package for these apps and calls it experimental. Keep your client secret in a file only you can read. developers.asana.com
Sharing a project needs your OK
Adding members, making a project public or changing its default access asks for your confirmation first. developers.asana.com
Admins can allow or block each AI app
On Enterprise+ and Legacy Enterprise, admins choose which AI apps can connect through App Management. developers.asana.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Asana MCP apps have no scopes, so there is no read-only mode. On Enterprise+ and Legacy Enterprise, admins can block a client entirely in App Management. |
|---|---|
| Talks to | mcp.asana.com (hosted by Asana) |
| Sign-in and keys | Sign-in with your Asana account. Access tokens last one hour and are refreshed; they only work with the MCP server, not the regular Asana API. Coding clients keep your app's client secret locally (Claude Code uses the system keychain). |
| Scopes |
|
Alternatives
Use Asana's hosted server unless you need several workspaces at once or a client it cannot sign in to. The community roychri server runs on your computer with a personal access token instead.
| Server | Official | Runs | Sign-in | Can change things | Tools | Weekly downloads |
|---|---|---|---|---|---|---|
| Asana MCPThis page | Official | Hosted | Asana account | Yes | 33 | – |
| roychri/mcp-server-asana | Community | Local | Access token | Yes | – | 2.3K/wk |
What people say
People like turning a chat into a real Asana project and dislike the one-workspace limit, the fiddly setup for coding tools and tool changes that broke their workflows.
What people like
- Turns a plan sketched in Claude into an Asana project with sections and tasks, with a preview before it is created
- Asana staff answer bug reports on the forum, and a task-creation bug users reported in April 2026 was fixed by May
- Comments, which were missing at launch, are now supported
Common complaints
- Each connection reaches only one workspace, which hurts people who work across many
- Coding tools need you to register your own Asana app first, and users called the docs confusing
- In March 2026 a tool change in the Claude connector stopped some users from creating tasks
- Interactive widgets in Claude can replace the text the assistant needs to read
- Users still ask for tags, adding a task to a second project and past status updates
In their words
“Why did you limit mcp to only single workspace? It makes it useless for many users”Damian_RachelVendorFeb 2026
“Can you please get Asana registered with Cursors available MCP server list? The docs are a bit too confusing for me to get this set up.”Cutler_McMartinVendorMar 2026
“Of course I was using the official Asana integration, not the “custom” one. BTW - creating tools with misleading names is a very bad practice when working with AIs as users, you need to then work around this with tool descriptions and prompts.”Andrzej_BrandtVendorJul 2026
“Why would I need interactive Asana UI inside Claude? Especially when I am talking to it while on the go?”Andrzej_Brandt
1 more quoteFewer quotes
Questions
What is the Asana MCP server URL?
https://mcp.asana.com/v2/mcp. The older https://mcp.asana.com/sse address is the beta version, which Asana has deprecated and is shutting down.
Is the Asana MCP server free?
Asana does not list a separate price for it. Asana lists the Claude app for Personal, Starter, Advanced, Enterprise and Enterprise+ plans; on a team account an admin must approve the app for the whole organization first.
Do I need a client ID and secret?
Only for coding tools such as Claude Code, Cursor, VS Code, Codex and Windsurf. You create a free MCP app in Asana's developer console to get them. The Asana apps inside Claude and ChatGPT handle this for you.
Is it safe to connect Asana to my AI assistant?
It can only reach what your Asana account can see, and everything it does shows up under your name. It can still create, change and delete tasks, so turn on your AI app's setting that asks before changes. In June 2025 a bug in the first version could expose some data to other Asana MCP users, and Asana took it offline for about two weeks to fix it.
Can it delete my Asana tasks?
Yes. Deleting a task also removes its subtasks unless they belong to another project.
Can I use it with more than one Asana workspace?
Not in one connection. You pick one workspace when you sign in, so you need a separate connection for each other workspace.
Why does it say the app is not available to my workspace?
Your Asana app is not shared with that workspace yet. In the developer console, open Manage distribution and add your workspace or choose Any workspace.
Why does Claude Code reject the Asana sign-in?
The return address in your Asana app must match the one Claude Code uses exactly. Asana's guide registers http://localhost:8080/callback and sets the same port in Claude Code; you can also connect Asana in claude.ai settings first.
Can my admin block AI apps from Asana?
Yes, on Enterprise+ and Legacy Enterprise admins can allow or block each AI app in App Management. On other plans a super admin can ask Asana Support to block the beta connector.
How do I add Asana to Claude?
On claude.ai or Claude Desktop, add Asana from the connectors directory and sign in. For Claude Code and other coding tools, use the install box above.
Examples
See what is on your plate this week
Find all my incomplete tasks due this week
SourceAdd a task without leaving the chat
Create a new task in the Marketing project assigned to me
SourceCheck how a project is going
Show me the status of the Q2 Planning project
SourceTurn a brainstorm into a structured project
Claude, use Asana to create a product launch campaign with sections for Positioning, Content Creation, Channel Activation, and Performance Tracking.
SourcePost a project status update
Post a green status update to the Q3 Roadmap project saying we are on track
Source
Information
updated Nov 2, 2026
- Publisher
- Asana (official)
- Endpoint
https://mcp.asana.com/v2/mcp- Transport
- Streamable HTTP
- Auth
- OAuth
- Listed in
- Docker MCP Catalog
Using Asana's MCP serverDocker MCP CatalogConnecting coding clientsAPI changelog
Other Asana MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 15Hide
- Asana for ChatGPT · help.asana.com
- Integrating with Asana's MCP Server · developers.asana.com
- Connecting Coding Clients to Asana's V2 server · developers.asana.com
- Asana connector for Claude · claude.com
- Asana app in Claude · help.asana.com
- Using Asana's MCP Server · developers.asana.com
- MCP Tools Reference · developers.asana.com
- Asana MCP server bug · theregister.com
- create_task missing from Claude connector (MCP) as of today · forum.asana.com
- Cannot connect Asana MCP to Claude Code CLI · forum.asana.com
- create_tasks persistent server error with Claude Code · forum.asana.com
- Official Asana integration pushes interactive widgets · forum.asana.com
- New V2 MCP server now generally available · forum.asana.com
- Asana app in Claude · asana.com
- Asana Forum: mcp-server tag · forum.asana.com