> ## 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.

# Overview

> Connect Kasava to task management and meeting intelligence platforms

Kasava integrates with leading project management and meeting intelligence platforms to provide a unified view of your work. All integrations are managed from a central settings page.

## Version Control & Code

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="/docs/integrations/github">
    Issues, Pull Requests, Projects V2, Commits, Repository Indexing
  </Card>
</CardGroup>

## Task Management

<CardGroup cols={2}>
  <Card title="Linear" icon="square-check" href="/docs/integrations/linear">
    Issues, Projects, Cycles, Teams, Two-Way Sync
  </Card>

  <Card title="Jira" icon="jira" href="/docs/integrations/jira">
    Issues, Projects, Sprints, Status Transitions
  </Card>

  <Card title="Asana" icon="list-check" href="/docs/integrations/asana">
    Tasks, Projects, Sections, Custom Fields
  </Card>

  <Card title="Trello" icon="table-columns" href="/docs/integrations/trello">
    Boards, Cards, Lists, Labels, Webhooks
  </Card>
</CardGroup>

## Meeting Intelligence

<CardGroup cols={2}>
  <Card title="Granola" icon="calendar" href="/docs/integrations/granola">
    Meeting Notes, Transcripts, AI Summaries, Manual Import
  </Card>

  <Card title="Gong" icon="phone" href="/docs/integrations/gong">
    Sales Calls, Transcripts, AI Insights, Competitor Tracking
  </Card>
</CardGroup>

## IDE & AI Agents

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="/docs/developer/claude-code-plugin">
    Plugin with 8 MCP tools, 6 Agent Skills, 8 slash commands, 4 subagents
  </Card>

  <Card title="Cursor" icon="code" href="/docs/developer/cursor-setup">
    MCP integration for code intelligence, product graph, plans
  </Card>
</CardGroup>

<Tip>
  See the full [Developer Tools](/docs/developer/overview) section for Claude Desktop, Copilot, Codex, and other AI agent integrations.
</Tip>

## Why Integrate?

### Unified View

See all your work items in one place, regardless of which platform they originated from. Link GitHub repositories alongside Linear, Jira, or Asana projects for complete visibility.

### AI-Powered Chat

Once connected, use natural language in the Kasava chat to create, update, and search issues across all your integrated platforms.

### Smart Linking

Link Plans and other Kasava entities directly to issues in your task management platform.

### Call Analysis

Meeting transcripts from Gong and Granola are automatically analyzed by AI to extract product insights, feature requests, and competitive intelligence.

## Managing Integrations

Navigate to **Settings > Integrations** to view and manage all your connected platforms.

<Steps>
  <Step title="Navigate to Settings">
    Click your profile menu in the top-right corner and select **Settings**, or use the sidebar to navigate to **Settings > Integrations**
  </Step>

  <Step title="Find Your Platform">
    Scroll to find the platform you want to connect.
  </Step>

  <Step title="Click Connect">
    Click the green **Connect** button on any available integration card
  </Step>

  <Step title="Authorize Access">
    You'll be redirected to the platform's OAuth authorization page. Grant Kasava the requested permissions.
  </Step>

  <Step title="Complete Setup">
    After authorization, you'll be redirected back to Kasava. The integration card will show a green "Connected" status.
  </Step>
</Steps>

## Integration Status

Each integration card displays its current status:

| Status    | Appearance                      | Meaning               |
| --------- | ------------------------------- | --------------------- |
| Available | Gray card with "Connect" button | Not yet connected     |
| Connected | Green background with checkmark | Integration is active |

## Connecting to Products

After connecting an integration at the organization level, you can link specific projects to Kasava Products:

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

  <Step title="Link External Project">
    In the "External Projects" section, click to link a GitHub, Linear, Jira, or Asana project
  </Step>

  <Step title="Select Project">
    Choose from your available projects in the connected platform
  </Step>

  <Step title="Configure Sync">
    Set up field mappings and sync preferences
  </Step>
</Steps>

## Data Sync

### How Sync Works

When you connect a platform and link it to a Product:

1. **Initial Import** - Kasava fetches existing issues/tasks from the linked project
2. **Ongoing Sync** - Changes sync bi-directionally between platforms
3. **Kanban View** - Issues appear on your Product's work view organized by status

### Real-Time Updates

For supported platforms, Kasava uses webhooks to receive instant updates when issues change.

### Manual Refresh

Click the refresh button on any Product to manually trigger a sync.

## Permissions Overview

Each platform requires specific OAuth permissions:

| Platform | Read Access                         | Write Access        |
| -------- | ----------------------------------- | ------------------- |
| GitHub   | Repositories, Issues, PRs, Projects | Issues, Comments    |
| Linear   | Issues, Projects, Cycles, Teams     | Issues, States      |
| Jira     | Issues, Projects, Sprints           | Issues, Transitions |
| Asana    | Tasks, Projects, Workspaces         | Tasks, Comments     |
| Trello   | Boards, Cards, Lists, Members       | Cards, Labels       |
| Granola  | Meeting Notes, Transcripts          | Read-only           |
| Gong     | Calls, Transcripts, Insights        | Read-only           |

## Managing Connected Integrations

For connected integrations, click **Manage** to:

* View connection status and last sync time
* Configure sync settings
* Refresh OAuth tokens if needed
* Disconnect the integration

## Disconnecting an Integration

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

  <Step title="Find the Connected Integration">
    Locate the integration card (it will have a green background)
  </Step>

  <Step title="Click Manage">
    Click the **Manage** button on the integration card
  </Step>

  <Step title="Disconnect">
    In the management dialog, click **Disconnect** and confirm
  </Step>
</Steps>

<Note>
  Disconnecting an integration removes Kasava's access to that platform. Any linked Products will no longer sync with that platform's projects.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Integration shows 'Needs Re-auth'">
    OAuth tokens expire periodically. Click the integration card and re-authorize to refresh your connection.
  </Accordion>

  <Accordion title="Issues aren't appearing in my Product">
    Check that the specific project is linked to your Product. Go to Product settings and verify the external project link is configured correctly.
  </Accordion>

  <Accordion title="Changes not syncing to the external platform">
    Verify that write permissions were granted during OAuth. You may need to disconnect and reconnect the integration, ensuring all requested permissions are approved.
  </Accordion>

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

## Security

Kasava handles integration credentials securely:

* All OAuth tokens are encrypted at rest
* Tokens are never exposed in the UI or logs
* You can revoke access anytime from your platform's settings (GitHub, Linear, etc.)
* Kasava uses standard OAuth 2.0 flows with PKCE where supported

## Next Steps

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="/docs/integrations/github">
    Connect GitHub for code intelligence and issue tracking
  </Card>

  <Card title="Linear" icon="square-check" href="/docs/integrations/linear">
    Connect Linear for modern issue management
  </Card>

  <Card title="Jira" icon="jira" href="/docs/integrations/jira">
    Connect Jira for enterprise issue tracking
  </Card>

  <Card title="Asana" icon="list-check" href="/docs/integrations/asana">
    Connect Asana for task management
  </Card>

  <Card title="Trello" icon="table-columns" href="/docs/integrations/trello">
    Connect Trello for Kanban workflows
  </Card>

  <Card title="Granola" icon="calendar" href="/docs/integrations/granola">
    Connect Granola for meeting transcripts and AI summaries
  </Card>

  <Card title="Gong" icon="phone" href="/docs/integrations/gong">
    Connect Gong for sales intelligence and call insights
  </Card>
</CardGroup>