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.Documentation Index
Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt
Use this file to discover all available pages before exploring further.
What Can It Do?
- Create and update tasks with assignees, due dates, tags, and custom fields
- 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
In Agents (Recommended)
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:- Open your agent’s configuration
- Click Add tools → Connect an app with MCP
- Search for the integration and select it
- Authenticate with your account
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.- Go to your node library and search for the integration
- Click Create a node with AI
- Describe the specific action you want (e.g., “Create a task in the Marketing project”)
- 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
| Tool | Description |
|---|---|
| Get User Details | Get current user’s details |
| List Projects | List accessible projects with filtering |
| Get Project | Get detailed project information |
| Add/Remove Project Members | Manage project membership |
| Add/Remove Project Followers | Manage project followers |
| List Tasks | List tasks by project, tag, assignee, or section |
| Create Task | Create a new task with assignee, due date, and custom fields |
| Get Task | Get detailed task information |
| Update Task | Update task properties including custom fields |
| Delete Task | Move a task to trash |
| Duplicate Task | Create a copy of a task |
| Create Subtask | Create a subtask under a parent task with custom field support |
| Get Subtasks | Get all subtasks of a task |
| Add/Remove Task Tags | Manage task tags |
| Add/Remove Task Followers | Manage task followers |
| Get Project Sections | Get all sections in a project |
| Get/Create Tags | Manage workspace tags |
| Get Portfolio | Get portfolio details |
| Get Portfolio Items | Get projects in a portfolio |
Example Prompts
Use these with your agent or in the Agent Node: Create a task:Troubleshooting
| Issue | Solution |
|---|---|
| Agent not finding the right data | Be specific with project names or use “in workspace X” for clarity |
| Action not completing | Check that you’ve authenticated and have permissions for the project |
| Unexpected results | The 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 available | Verify the tool is enabled in your agent’s MCP configuration |
Need Help?
- Agents documentation for setup and best practices
- Agent Node guide for workflow integration
- Gumloop Community for questions and examples
- Contact support@gumloop.com for assistance
Use this integration directly in Claude or Cursor. Connect remotely via the Asana MCP server using your Gumloop credentials.