Asana MCP
Connect Asana to manage tasks, projects, and team workflows
Connect your Asana account to give your AI assistant access to tasks, projects, workspaces, and team collaboration features.
Overview
The Asana integration lets your AI:
- Manage Tasks - Create, update, and search tasks across projects
- Track Projects - View project status, timelines, and progress
- Access Workspaces - Navigate teams and workspace structures
- Collaborate - Add comments, assign tasks, and update due dates
Prerequisites
- An Asana account
- Pro plan or higher on Chipp
Connecting Asana to Chipp
Asana uses app-level OAuth authentication. You connect your Asana account once, and all users of your app can access Asana tools - no individual user authentication required.
- Go to app.chipp.ai and open your app
- Click Build in the sidebar
- Scroll to Capabilities
- Click Add Pro Action
- Find Asana in the integration list
- Click Connect
- Sign into your Asana account and grant permission
- Select which tools to enable
- Click Save
Once connected, all users of your app can immediately use Asana tools without any additional setup.
The Asana account you connect determines which workspaces and projects are accessible. All app users will have access to the same Asana data based on your account's permissions.
How App-Level OAuth Works
Asana uses app-level OAuth, which is different from user-level OAuth:
- You connect once - As the app owner, you authorize Asana access
- All users benefit - Every user of your app can use Asana tools immediately
- Shared access - Users access the Asana data from your connected account
- Centralized control - You manage permissions from one place
This is ideal for team tools where you want everyone to access the same Asana workspace.
Available Tools
Asana tools are discovered dynamically when you connect your account. Common capabilities include:
Task Management
- Create tasks - Add new tasks with titles, descriptions, and due dates
- Update tasks - Modify task details, assignees, and status
- Search tasks - Find tasks by name, project, or assignee
- Complete tasks - Mark tasks as done
Project Operations
- List projects - View all projects in a workspace
- Get project details - See project status, members, and tasks
- Create projects - Start new projects with templates
Workspace Access
- List workspaces - See available workspaces and teams
- Get workspace members - View team members and their roles
Example Workflows
Task Management Assistant
System prompt:
You help users manage Asana tasks. When they ask about tasks, search Asana. Help them create new tasks, update existing ones, and track project progress.
User interaction:
User: "What tasks are due this week?" AI: Let me check Asana... [Calls: Search tasks with due date filter] You have 5 tasks due this week: 1. **Review Q4 budget** - Due Tuesday Project: Finance Planning 2. **Update website copy** - Due Wednesday Project: Marketing Campaign 3. **Team sync prep** - Due Thursday Project: Weekly Operations Would you like me to update any of these or create new tasks?
Project Status Reporter
System prompt:
You provide project status updates from Asana. When asked about a project, retrieve its details, task completion rate, and any overdue items.
User interaction:
User: "How's the product launch project going?" AI: [Calls: Get project details] [Calls: Search tasks in project] **Product Launch Project Status:** - **Overall Progress:** 68% complete (17/25 tasks done) - **On Track:** Yes - **Due Date:** December 20, 2025 **Remaining Tasks:** - 5 tasks in progress - 3 tasks not started **Overdue Items:** - "Finalize pricing" - 2 days overdue (assigned to Sarah) Would you like me to send a reminder or update any tasks?
Quick Task Creator
System prompt:
You help users quickly capture tasks in Asana. When they mention something they need to do, offer to create a task with appropriate details and project assignment.
User interaction:
User: "I need to call the vendor about the contract tomorrow" AI: I can create an Asana task for that. Here's what I'll add: **Title:** Call vendor about contract **Due Date:** Tomorrow **Project:** (Would you like to assign this to a specific project?) [User confirms] AI: [Calls: Create task] Done! I've created the task "Call vendor about contract" due tomorrow. View it here: [link to task]
Best Practices
Connect the right account: The Asana account you connect determines what data is available. Use an account with access to the workspaces and projects your app needs.
Be specific about projects: When creating or searching tasks, ask users which project to use if it's not clear from context.
Handle multiple workspaces: If your Asana account has access to multiple workspaces, configure your system prompt to clarify which one to use.
Consider permissions: All app users will have access to the same Asana data. Make sure you're comfortable sharing that access with your app's users.
Troubleshooting
"Asana not connected" error
This means the app owner hasn't connected their Asana account yet:
- Go to your app's Build settings
- Find Asana in Pro Actions
- Click Connect and authorize access
Can't see certain projects or tasks
- The connected Asana account may not have access to those projects
- Check the account's permissions in Asana directly
- Consider connecting a different Asana account with broader access
OAuth authorization fails
- Ensure pop-ups aren't blocked in the browser
- Try in an incognito window
- Clear browser cookies and try again
- Check if Asana is experiencing any outages
Tools not appearing after connecting
- Tools are discovered when you first connect
- Try disconnecting and reconnecting the integration
- Check that your Asana account has the necessary permissions
Next Steps
MCP Overview
Explore all available Pro Action integrations
Getting Started
Learn the basics of connecting MCP services