# Asana

The Asana integration allows you to sync your project management workflows with Calk and empower your AI assistants to understand tasks, teams, and timelines instantly. Once connected, your Asana data becomes available to power ultra-specific agents, contextual assistants, and automated reporting.

***

### 🚀 How to Connect Asana

1. **Go to Knowledge Hub** → "Integrations" → click on **Asana**.
2. Hit the **"Connect"** button.
3. You’ll be redirected to an Asana authentication screen.
4. Approve access to the Asana workspace and projects you’d like Calk to use.
5. Once connected, Calk will automatically pull the following data (permissions list below 👇).

***

### 🧠 What Calk Pulls from Asana & Why

| **Permission**    | **Description**                                                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `View Projects`   | Lists projects in your workspace. Enables assistants to identify project goals and generate project-based content or summaries. |
| `View Workspaces` | Lists Asana workspaces. Helps agents scope which teams to act on and keeps data organized.                                      |
| `View Users`      | Lists users in the workspace. Used to assign, tag, or mention users inside agent responses or tasks.                            |
| `View Tasks`      | Lists tasks across projects. Allows agents to generate task summaries, identify overdue work, or suggest improvements.          |

***

### ✨ Use Cases with Asana

Here’s how your team can immediately benefit from connecting Asana to Calk:

* **AI Project Summarizer**: Create an agent that summarizes all active or overdue tasks from your Asana board every morning.
* **Meeting Prep Assistant**: Fetch tasks assigned to a person or team and summarize progress for daily/weekly syncs.
* **Customer-Facing Insights**: For client-facing teams, generate summaries of project status to share during calls or updates.
* "Show me all overdue tasks across my projects"
* "What did the marketing team complete this week?"
* "Show me all tasks due this week"
* "What tasks are blocked or waiting for dependencies?"

***

### 🛠️ Next Step: Build an Assistant

Now that your Asana is connected:

1. Go to the **Agent** tab.
2. Create a new one, or edit an existing agent.
3. In the "Knowledge & Tools" tab, check **Asana** under "Connect Integrations".
4. Your agent will now have live access to your Asana tasks, users, and more!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.calk-ai.com/knowledge/integrations/asana.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.