# Asana 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** - Assign tasks and update due dates ## Prerequisites - An [Asana](https://asana.com) account - Studio plan or higher on Chipp ## Connecting Asana to Chipp Asana uses OAuth authentication. You connect your Asana account once, and all users of your app can access Asana tools -- no individual user authentication required. 1. Go to [build.chipp.ai](https://build.chipp.ai) and open your app 2. Click **Brain** in the sidebar 3. Open the **Integrations** tab and click **Browse all integrations** 4. Find **Asana** in the integrations list 5. Click **Connect Asana** and sign into your Asana account 6. Grant permission for Chipp to access your Asana data 7. All Asana tools are on by default. Use the switches under **Tools** to turn off any you do not want Once connected, all users of your app can immediately use Asana tools without any additional setup. > **Note:** 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. ## Available Tools Common capabilities include: ### Task Management - **List tasks** - View tasks in a project with status and assignee info - **Get task details** - See full task details including notes, assignee, projects, section, and tags - **Create tasks** - Add new tasks with titles, notes, assignees, and due dates - **Update tasks** - Modify task details, assignees, and due dates, or mark tasks complete - **Search tasks** - Find tasks in a workspace by text in their names and descriptions ### Project Operations - **List projects** - View all projects in a workspace ### Workspace Access - **List workspaces** - See available workspaces and teams ## 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: List projects] [Calls: List 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? ``` ## 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: 1. Go to your app's **Brain** settings 2. Open the **Integrations** tab and click **Browse all integrations** 3. Find Asana and click **Connect Asana** ### 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 - Try disconnecting and reconnecting the integration - Check that your Asana account has the necessary permissions ## Next Steps