> ## Documentation Index
> Fetch the complete documentation index at: https://kasava.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> Connect Asana projects and tasks to Kasava Products

Asana is a work management platform used by many product and engineering teams. Kasava integrates with Asana to bring your tasks into Products and enable AI-powered task management.

## Capabilities

| Feature             | Description                         |
| ------------------- | ----------------------------------- |
| Task Sync           | Import Asana tasks to Products      |
| AI Chat Integration | Manage tasks using natural language |
| Project Mapping     | Link Asana projects to Products     |
| Section Mapping     | Map sections to Kanban columns      |
| Custom Fields       | Sync Asana custom fields            |
| Subtask Support     | View and manage task hierarchies    |

## Connecting Asana

<Steps>
  <Step title="Navigate to Settings">
    Go to **Settings > Integrations** in the sidebar
  </Step>

  <Step title="Find Asana">
    In the **Task Management** section, locate the Asana integration card
  </Step>

  <Step title="Click Connect">
    Click the green **Connect** button to start the OAuth flow
  </Step>

  <Step title="Sign In to Asana">
    If not already signed in, enter your Asana credentials
  </Step>

  <Step title="Authorize Access">
    Review the permissions Kasava is requesting and click **Allow**
  </Step>

  <Step title="Connection Complete">
    You'll be redirected back to Kasava with a "Connected Successfully" message. The Asana card will show a green connected status.
  </Step>
</Steps>

## What You Can Do Once Connected

After connecting Asana, you can:

* **Sync Asana tasks to Products** - Link Asana projects to Kasava Products for unified views
* **Use AI chat for task management** - Create and update tasks using natural language
* **View tasks in Kanban** - See Asana tasks organized by section
* **Link tasks to GitHub PRs** - Connect code changes to task management

## Linking Asana to a Product

To sync Asana tasks with a specific Kasava Product:

<Steps>
  <Step title="Open Product Settings">
    Navigate to your Product and click the settings icon
  </Step>

  <Step title="Add External Project">
    In the external projects section, click to add a new link
  </Step>

  <Step title="Select Asana">
    Choose "Asana" as the platform
  </Step>

  <Step title="Choose Project">
    Select the Asana project to sync from your workspace
  </Step>

  <Step title="Configure Mapping">
    Review section-to-column mappings and confirm the connection
  </Step>
</Steps>

### Field Mapping

When tasks sync between Asana and Kasava:

| Asana Field   | Kasava Field  |
| ------------- | ------------- |
| Section       | Kanban column |
| Assignee      | Assignee      |
| Tags          | Labels        |
| Due Date      | Due date      |
| Custom Fields | Custom fields |
| Description   | Description   |

## Sections as Columns

Asana project sections become Kanban columns in Kasava:

* Each Asana section creates a corresponding column
* Column order matches section order in Asana
* Tasks in a section appear in that column
* Moving tasks between columns updates their section in Asana

<Tip>
  If your Asana project has many sections, consider grouping related ones into fewer Kasava columns for a cleaner board view.
</Tip>

## Working with Tasks

### Task Properties

Tasks sync with full detail:

* Title and description (rich text supported)
* Assignee
* Due date
* Tags
* Subtasks
* Comments
* Attachments (links preserved)

### Subtasks

Asana subtasks appear as child items in Kasava:

* View subtasks expanded inline
* Open subtask details
* Mark subtasks complete independently
* Subtask completion updates in Asana

## Custom Fields

Asana custom fields sync to Kasava:

| Asana Type      | Kasava Display |
| --------------- | -------------- |
| Text            | Text field     |
| Number          | Number field   |
| Enum (dropdown) | Select field   |
| Multi-enum      | Multi-select   |
| Date            | Date picker    |
| People          | User picker    |

Custom fields appear in the task detail view and can be used for filtering.

## Using Asana in AI Chat

Once connected, you can manage Asana tasks using natural language in Kasava's chat:

**Example commands:**

* "Create a new Asana task for the homepage redesign"
* "Show me all overdue tasks in Asana"
* "Assign the onboarding task to Maria"
* "What tasks are due this week?"

## @kasava Commands in Tasks

Use `@kasava` mentions in Asana task comments to trigger AI-powered actions directly from your workflow.

### How It Works

1. Add a comment on any Asana task with `@kasava` followed by a command
2. Kasava detects the mention via webhooks
3. The AI processes your request using the task context
4. Results are posted as a reply comment on the task

### Available Commands

| Command               | Description                          |
| --------------------- | ------------------------------------ |
| `@kasava summarize`   | Summarize the task discussion        |
| `@kasava document`    | Generate documentation from the task |
| `@kasava plan`        | Create an implementation plan        |
| `@kasava design-doc`  | Generate a design document           |
| `@kasava prototype`   | Create a prototype spec              |
| `@kasava diagnose`    | Analyze the problem described        |
| `@kasava postmortem`  | Generate a postmortem analysis       |
| `@kasava insights`    | Extract key insights                 |
| `@kasava changelog`   | Generate changelog entries           |
| `@kasava report`      | Create a status report               |
| `@kasava review-prep` | Prepare for a review meeting         |

### Example Usage

```
@kasava summarize last 5 comments
@kasava plan
@kasava insights since last week
```

### Custom Commands

Your organization can create custom action types in **Settings > Templates > Action Types** that work in Asana just like built-in commands.

### Authorization

Workspace members in your Kasava organization can use commands. Enable external collaborators in **Settings > Integrations > Permissions** if needed.

## Managing the Connection

To manage your Asana connection:

<Steps>
  <Step title="Go to Settings > Integrations">
    Navigate to the integrations settings page
  </Step>

  <Step title="Find Asana">
    Locate the connected Asana card (green background)
  </Step>

  <Step title="Click Manage">
    Click the **Manage** button to open the management dialog
  </Step>
</Steps>

From the management dialog, you can:

* View connection status
* See the connected workspace
* Disconnect the integration

## Disconnecting Asana

<Steps>
  <Step title="Open Asana Management">
    Go to **Settings > Integrations** and click **Manage** on the Asana card
  </Step>

  <Step title="Click Disconnect">
    Click the **Disconnect** button
  </Step>

  <Step title="Confirm">
    Confirm that you want to disconnect
  </Step>
</Steps>

<Note>
  Disconnecting Asana removes Kasava's access to your Asana workspace. Any linked Products will no longer sync with Asana projects. Your Asana data is not deleted.
</Note>

## What's Not Synced

Some Asana features are not directly synced:

* **Portfolios** - Projects within portfolios can be individually linked
* **My Tasks view** - Use Kasava's filtering to see tasks assigned to you
* **Goals** - Asana Goals are not imported

## Troubleshooting

<AccordionGroup>
  <Accordion title="Tasks not appearing in my Product">
    Verify that the Asana project is linked to your Product in Product settings. Check that tasks are not in a section excluded from sync.
  </Accordion>

  <Accordion title="Sections not mapping correctly">
    Review section mappings in Product settings. Newly created sections in Asana may need to be manually mapped to columns.
  </Accordion>

  <Accordion title="Custom fields missing">
    Ensure the custom field is added to the project in Asana (not just the workspace). Some complex field types may not be supported.
  </Accordion>

  <Accordion title="OAuth authorization failed">
    If you see an error after authorizing, try clearing your browser cookies for app.asana.com and attempting the connection again from Kasava.
  </Accordion>
</AccordionGroup>

## Permissions

Kasava requests these Asana permissions during OAuth:

| Permission     | Purpose                          |
| -------------- | -------------------------------- |
| Read tasks     | View tasks and projects          |
| Write tasks    | Create and update tasks          |
| Profile access | User information for assignments |

## Security

* OAuth tokens are encrypted at rest
* Tokens are never exposed in the UI
* Disconnect anytime from Kasava or Asana's settings
* No passwords stored

## Related

<CardGroup cols={2}>
  <Card title="Products" icon="layer-group" href="/docs/features/products">
    Link Asana projects to Products
  </Card>

  <Card title="AI Chat" icon="message-circle" href="/docs/features/ai-chat">
    Use chat to manage Asana tasks
  </Card>

  <Card title="Trello Integration" icon="table-columns" href="/docs/integrations/trello">
    Alternative: Connect Trello
  </Card>

  <Card title="Integrations Overview" icon="plug" href="/docs/integrations/overview">
    All available integrations
  </Card>
</CardGroup>