PlugWiki

Asana MCP server: connect Asana to Claude, ChatGPT and Cursor

Official · by AsanaRemote
Gethttps://mcp.asana.com/v2/mcpDocs

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.

Install Asana MCP

Claude Code

  1. 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. 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_tasks

  • Finds 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_objects

  • Lists 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_tasks

  • Searches 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_tasks

  • Shows 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_task

  • Shows 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_stories

  • Summarizes 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_overview

  • Shows 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_project

  • Lists 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_projects

  • Lists the portfolios you own

    Lists the portfolios you own in the current workspace.

    Try: “What portfolios do I own?”

    Network · get_portfolios

  • Shows 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_portfolio

  • Lists 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_portfolio

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-onlyAsana 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 tomcp.asana.com (hosted by Asana)
Sign-in and keysSign-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
  • No permission scopes: every authorization can use every tool, now and any added later

  • Limited to the one workspace chosen at sign-in and to what that user can already see

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.

ServerOfficialRunsSign-inCan change thingsToolsWeekly downloads
Asana MCPThis pageOfficialHostedAsana accountYes33–
roychri/mcp-server-asanaCommunityLocalAccess tokenYes–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

1 more quote

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

    Source
  • Add a task without leaving the chat

    Create a new task in the Marketing project assigned to me

    Source
  • Check how a project is going

    Show me the status of the Q2 Planning project

    Source
  • Turn 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.

    Source
  • Post 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 15
  1. Asana for ChatGPT · help.asana.com
  2. Integrating with Asana's MCP Server · developers.asana.com
  3. Connecting Coding Clients to Asana's V2 server · developers.asana.com
  4. Asana connector for Claude · claude.com
  5. Asana app in Claude · help.asana.com
  6. Using Asana's MCP Server · developers.asana.com
  7. MCP Tools Reference · developers.asana.com
  8. Asana MCP server bug · theregister.com
  9. create_task missing from Claude connector (MCP) as of today · forum.asana.com
  10. Cannot connect Asana MCP to Claude Code CLI · forum.asana.com
  11. create_tasks persistent server error with Claude Code · forum.asana.com
  12. Official Asana integration pushes interactive widgets · forum.asana.com
  13. New V2 MCP server now generally available · forum.asana.com
  14. Asana app in Claude · asana.com
  15. Asana Forum: mcp-server tag · forum.asana.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.