Skip to main content
Asana is a work management platform for organizing projects, tasks, and team collaboration. The Asana MCP server lets you create tasks, manage projects, and track work using natural language.

​
What Can It Do?

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

​
Where to Use It

Add Asana as a tool to any agent. The agent can then interact with your projects and tasks conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Asana tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Create a task in the Marketing project”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

ToolDescription
Get User DetailsGet current user’s details
List ProjectsList accessible projects with filtering
Get ProjectGet detailed project information
Add/Remove Project MembersManage project membership
Add/Remove Project FollowersManage project followers
List TasksList tasks by project, tag, assignee, or section
Create TaskCreate a new task with assignee and due date
Get TaskGet detailed task information
Update TaskUpdate task properties
Delete TaskMove a task to trash
Duplicate TaskCreate a copy of a task
Create SubtaskCreate a subtask under a parent task
Get SubtasksGet all subtasks of a task
Add/Remove Task TagsManage task tags
Add/Remove Task FollowersManage task followers
Get Project SectionsGet all sections in a project
Get/Create TagsManage workspace tags
Get PortfolioGet portfolio details
Get Portfolio ItemsGet projects in a portfolio

​
Example Prompts

Use these with your agent or in the Agent Node: Create a task: 
Create a task "Review Q4 budget" in the Finance project, assign to [email protected], due next Friday
Find tasks: 
Show me all tasks assigned to me that are due this week
Update task status: 
Mark the task "Prepare presentation" as complete
Manage project access: 
Add [email protected] as a member to the Product Launch project
Get project overview: 
List all sections in the Marketing Campaign project

​
Troubleshooting

IssueSolution
Agent not finding the right dataBe specific with project names or use “in workspace X” for clarity
Action not completingCheck that you’ve authenticated and have permissions for the project
Unexpected resultsThe agent may chain multiple tools (e.g., finding the project first, then creating a task). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Create a task in the Marketing project” will find the project ID first, then create the task. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the Asana MCP server using your Gumloop credentials.