Connect Asana projects, tasks, and teams to your automated workflows. Quickly list or create tasks, manage project access, organize work with sections and tags, and keep portfolios current using simple natural language prompts.
Work seamlessly with projects, tasks, sections, tags, and portfolios in your Asana workspace, including membership and follower management.

​
What is Asana MCP?

The Asana MCP lets you describe what you need in plain language while it handles the Asana API behind the scenes. Your node returns structured data you can pass effortlessly to the next step in any workflow.

​
What Can It Do for You?

  • Create, update, and organize tasks with assignees, due dates, and tags
  • Retrieve tasks by project, assignee plus workspace, tag, or section for streamlined reporting
  • Manage project access by adding or removing members and followers
  • Explore portfolios and sections to keep stakeholders informed

​
Available Tools

ToolWhat It DoesExample Use
Get User DetailsGet the current logged-in user’s details from Asana”Return structured data with my user id, name, and email”
List ProjectsList projects accessible to the current user with optional filtering and pagination”List projects I can access, filter by names containing search term, and return project name and id”
Get ProjectGet detailed information about a specific project by its GID”Using project id, get the project and return name, owner, due date, and url”
Add Project MembersAdd specified users as members to a project by GID or email”Using project id, add members user emails and return added member emails”
Remove Project MembersRemove specified users from project membership by GID or email”Using project id, remove members user emails and return removed member emails”
Add Project FollowersAdd specified users as followers to a project”Using project id, add followers user emails and return follower emails”
Remove Project FollowersRemove specified users from following a project”Using project id, remove followers user emails and return follower emails”
List TasksList tasks with optional filtering and pagination. Specify a project, tag, assignee + workspace, or section”List tasks assigned to assignee email in workspace workspace name and return task id, name, and due date”
Create TaskCreate a new task in a workspace and optionally add it to projects”Create a task titled task title in workspace workspace name and project project name, assign to assignee email, set due date due date, and return task id, name, and url”
Get TaskGet detailed information about a specific task by its GID”Using task id, get task details and return name, assignee, due date, completed, and url”
Update TaskUpdate an existing task. Only specified fields are updated”Using task id, update name to new name, set due date to new due date, mark completed true or false, and return updated name, due date, and completed”
Delete TaskMove a task to trash (recoverable within 30 days)“Using task id, delete the task and return task id and status”
Duplicate TaskCreate a duplicate of an existing task with customizable fields to copy”Using task id, duplicate the task to new task name, copy subtasks and assignee, then return new task id and url”
Create SubtaskCreate a new subtask under an existing parent task”Using parent task id, create a subtask titled subtask title assigned to assignee email and return subtask id and name”
Get SubtasksGet all subtasks of a parent task with pagination”Using parent task id, list subtasks and return id, name, and completed”
Get Task DependenciesGet all tasks that this task depends on”Using task id, list dependency tasks and return id and name”
Add Task To ProjectAdd a task to a project with optional positioning (a task can be in up to 20 projects)“Using task id and project id, add the task to the project and optionally place it in section section name, then return confirmation”
Remove Task From ProjectRemove a task from a project”Using task id and project id, remove the task from the project and return confirmation”
Add Tag To TaskAdd a tag to a task”Using task id and tag id, add the tag to the task and return task id and tag names”
Remove Tag From TaskRemove a tag from a task”Using task id and tag id, remove the tag from the task and return task id and tag names”
Add Followers To TaskAdd followers to a task by GID or email”Using task id, add followers user emails and return follower emails”
Remove Followers From TaskRemove followers from a task”Using task id, remove followers user emails and return follower emails”
Get Project SectionsGet all sections in a project with pagination”Using project id, list sections and return section id and name”
Get Task TagsGet all tags associated with a specific task”Using task id, list all tags and return tag id and name”
Get Workspace TagsGet all tags in a workspace with pagination”Using workspace id, list tags and return tag id and name”
Create TagCreate a new tag in a workspace”Using workspace id, create a tag named tag name and return tag id and name”
Get PortfolioGet detailed information about a specific portfolio by its GID”Using portfolio id, get portfolio details and return name, owner, and created date”
Get Portfolio ItemsGet all items (projects) in a portfolio with pagination”Using portfolio id, list items and return project id and name”

​
How to Use

1

Create Your Asana MCP Node

Go to your node library, search for Asana, and click “Create a node with AI”
2

Add Your Prompt

Drag the Asana MCP node to your canvas and add your prompt in the text box.
3

Test Your Node

Run the node to see the results. If it looks good, you are all set. If you need tweaks, check the troubleshooting tips below.
4

Save and Reuse

Once your Asana MCP node is working, save it to your library. You can now reuse this customized node in any workflow.

​
Example Prompts

Here are reliable, automation-ready prompts for common scenarios:
  • Find a project by name and get its id
    ”List projects I can access, filter by name matching project name, and return project id and url”
  • Create and assign a task
    ”Create a task titled task title in workspace workspace name and project project name, assign to assignee email, set due date due date, and return structured data with task id, name, and url”
  • Retrieve tasks for a teammate
    ”List tasks assigned to assignee email in workspace workspace name and return structured data with task id, name, and due date”
  • Mark a task complete
    ”Using task id, update the task to completed true and return structured data with task id, name, and completed”
  • Add members to a project
    ”Using project id, add members user emails and return structured data with added member emails”
  • Get project sections
    ”Using project id, list sections and return structured data with section id and name”
Start with retrieval prompts to collect ids such as project id or task id. Save small, focused nodes and chain them together for robust workflows.

​
Troubleshooting

If your Asana MCP node is not behaving as expected, use these best practices:

​
Keep Prompts Simple and Specific

  • Good: “List tasks assigned to assignee email in workspace workspace name and return task id, name, and due date”
  • Less Efficient: “Find project name, list overdue tasks, create a summary task, and add followers user emails in one go”
For better results, build several small Asana nodes rather than combining many actions in one prompt. Asana MCP works best with focused, single-action prompts.

​
Match What Asana Can Do

  • Good: “Using task id, add followers user emails and return follower emails”
  • Less Efficient: “Using task id, send a Slack message to the assignee and return the message link”
Asana MCP excels at work management in Asana. For messaging, combine it with a Slack node in your workflow.

​
Break Complex Tasks Into Steps

Instead of trying to do everything in one prompt (which might cause timeouts or errors): 
Find project matching `project name`, list tasks due before `date`, create a task titled `task title`, and add followers `user emails`
Break this into smaller, focused nodes:
1

Step 1: Get Project

List projects, filter by name project name, and return project id
2

Step 2: List Tasks

Using project id, list tasks due before date and return task ids and names
3

Step 3: Create Task

Create a task titled task title in project id and return task id and url
4

Step 4: Add Followers

Using task id, add followers user emails and return follower emails
Connect these nodes sequentially in your workflow. The project id from Step 1 feeds Step 2, and the task id from Step 3 feeds Step 4.

​
Focus on Data Retrieval

Asana MCP is great at getting information from Asana. For analysis or writing summaries, connect it to other nodes. Example:
  • Good prompt: “Using project id, list sections and return section id and name”
  • Less Efficient: “List sections and write a status summary for leadership”
Use Ask AI for analysis or summarization. Keep your Asana MCP prompt focused on retrieving structured data.

​
Troubleshooting Node Creation

In the node creation window, click “Request changes” and ask the AI to add debug logs and verify the API response.
In the node creation window, click “Request changes” and describe what you expected versus what you received.
First click “Fix with Gummie”. If multiple attempts fail, simplify your prompt or contact support.
MCP node creation often benefits from a few tweaks. Use “Request changes” (in the node creation window) to refine filters, output fields, or pagination.

​
Need More Help?