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

# Integrations

> Connect the apps your team already uses and let AI agents act and react automatically

Mantle integrations extend your AI agents in two directions: they can **act** inside connected apps and **react** to
events that happen there.

<CardGroup cols={2}>
  <Card title="Tools" icon="wrench">
    Actions an agent can perform inside a connected app — create an issue, send a message, query a database, update a
    record.
  </Card>

  <Card title="Triggers" icon="bolt">
    Events in a connected app that automatically start an agent task — a new Linear issue, a Stripe payment, an incoming
    Slack message.
  </Card>
</CardGroup>

***

## Tools vs Triggers

|                | Tools                                     | Triggers                                 |
| -------------- | ----------------------------------------- | ---------------------------------------- |
| **Direction**  | Agent → App                               | App → Agent                              |
| **Started by** | A user prompt or another agent step       | An external event                        |
| **Example**    | Create a Linear issue from a chat message | Start a task when a new issue is created |
| **Connection** | API key (MCP)                             | Webhook / OAuth                          |

Some integrations provide only tools (e.g. Notion). Some provide only triggers. Some — like **Linear** and **Stripe** —
support both, connected independently so you can set up just what you need.

***

## Available integrations

### Communication

<CardGroup cols={2}>
  <Card title="Slack" icon="slack" href="/integrations/slack">
    Send messages, search conversations, and manage channels. Includes 9 webhook triggers.
  </Card>

  <Card title="Gmail" icon="envelope" href="/integrations/gmail">
    Draft replies, triage your inbox, and manage email. Trigger on new messages.
  </Card>

  <Card title="LinkedIn" icon="linkedin" href="/integrations/linkedin">
    Create posts, share articles, and engage with your professional network.
  </Card>

  <Card title="Discord" icon="discord" href="/integrations/discord">
    Send messages, manage channels, and moderate your community server.
  </Card>

  <Card title="X (Twitter)" icon="x-twitter" href="/integrations/twitter">
    Post tweets and upload media on the X platform.
  </Card>

  <Card title="Telegram" icon="telegram" href="/integrations/telegram">
    Send and receive messages in Telegram chats and groups via bot.
  </Card>

  <Card title="WhatsApp" icon="whatsapp" href="/integrations/whatsapp">
    Send and receive messages via WhatsApp Business API.
  </Card>
</CardGroup>

### Productivity

<CardGroup cols={2}>
  <Card title="Notion" icon="book-open" href="/integrations/notion">
    Search pages, create documents, and query databases in your Notion workspace.
  </Card>

  <Card title="Google Calendar" icon="calendar" href="/integrations/google-calendar">
    Create events, check availability, and manage your schedule.
  </Card>

  <Card title="Google Drive" icon="hard-drive" href="/integrations/google-drive">
    Browse, upload, and manage files in Google Drive.
  </Card>

  <Card title="Google Sheets" icon="table" href="/integrations/google-sheets">
    Read, write, and update spreadsheet data.
  </Card>

  <Card title="Google Docs" icon="file-lines" href="/integrations/google-docs">
    Create, read, and edit documents in Google Docs.
  </Card>

  <Card title="Airtable" icon="table-columns" href="/integrations/airtable">
    Read and update records in Airtable bases and tables.
  </Card>

  <Card title="Granola" icon="microphone" href="/integrations/granola">
    Capture and organize meeting notes automatically.
  </Card>
</CardGroup>

### CRM

<CardGroup cols={2}>
  <Card title="Ashby" icon="users" href="/integrations/ashby">
    Manage candidates, jobs, and recruiting pipelines.
  </Card>
</CardGroup>

### Project Management

<CardGroup cols={2}>
  <Card title="Linear" icon="circle-dot" href="/integrations/linear">
    Create and manage issues, track projects, and automate workflows. Includes native chat features.
  </Card>

  <Card title="Jira" icon="jira" href="/integrations/jira">
    Create issues, manage sprints, and track project progress.
  </Card>

  <Card title="Confluence" icon="confluence" href="/integrations/confluence">
    Search and manage pages and spaces in Confluence.
  </Card>

  <Card title="Asana" icon="list-check" href="/integrations/asana">
    Create tasks, manage projects, and track work across teams.
  </Card>
</CardGroup>

### Developer Tools

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="/integrations/github">
    Access repositories, manage issues and pull requests, and search code.
  </Card>

  <Card title="Neon" icon="database" href="/integrations/neon">
    Query and manage Neon serverless Postgres databases.
  </Card>

  <Card title="Supabase" icon="database" href="/integrations/supabase">
    Query data and manage your Supabase project.
  </Card>

  <Card title="Figma" icon="pen-ruler" href="/integrations/figma">
    Access design files, components, and comments.
  </Card>

  <Card title="Firecrawl" icon="spider" href="/integrations/firecrawl">
    Crawl and scrape web pages for AI context.
  </Card>

  <Card title="SerpApi" icon="magnifying-glass" href="/integrations/serpapi">
    Search Google and other engines programmatically.
  </Card>

  <Card title="Tavily" icon="magnifying-glass" href="/integrations/tavily">
    AI-optimized web search for real-time answers.
  </Card>

  <Card title="PostHog (US)" icon="chart-line" href="/integrations/posthog-us">
    Track analytics events and manage feature flags (US cloud).
  </Card>

  <Card title="PostHog (EU)" icon="chart-line" href="/integrations/posthog-eu">
    Track analytics events and manage feature flags (EU cloud).
  </Card>

  <Card title="Resend" icon="paper-plane" href="/integrations/resend">
    Send transactional and marketing emails via API.
  </Card>

  <Card title="Better Stack" icon="signal" href="/integrations/better-stack">
    Monitor uptime, query logs, and manage incidents.
  </Card>
</CardGroup>

### Finance

<CardGroup cols={2}>
  <Card title="Stripe" icon="stripe" href="/integrations/stripe">
    Manage customers, payments, subscriptions, and billing. Includes webhook triggers.
  </Card>
</CardGroup>

***

## How to connect

<Steps>
  <Step title="Open Settings → Integrations">In any workspace, go to **Settings → Integrations**.</Step>
  <Step title="Select an integration">Click an integration in the left panel to open its detail view.</Step>

  <Step title="Connect">
    Follow the steps shown — either paste an API key or authorise via OAuth. The panel shows clearly which features each
    connection method unlocks.
  </Step>

  <Step title="Start using it">
    Once connected, tools are immediately available to any agent in that workspace. To use triggers, add a trigger to a
    task in the agent editor.
  </Step>
</Steps>

<Tip>
  Tools and Triggers connect independently. For integrations that support both — like Linear and Stripe — you can
  connect only one if that's all you need.
</Tip>

***

## Connection methods

### API key (MCP)

The most common connection type. You paste a personal API key from the connected service, and Mantle uses it to act on
your behalf. The key is stored encrypted and never shared.

Used by: Linear (tools), Stripe (tools), Notion, and others.

### OAuth

A browser-based authorisation flow. You grant Mantle specific permissions in the connected service without sharing your
password or API key. Used when the integration needs to receive events (webhooks) or when the service requires OAuth.

Used by: Linear (triggers), Slack, Gmail.

### Native

Some integrations go deeper than tools and triggers — they add features directly into the Mantle chat UI. For example,
the Linear integration lets you create issues, link issues, and add comments from any message's action menu, and
subscribe channels to receive real-time Linear notifications.

Native features are unlocked automatically once the API key connection is active.

***

## Permissions and security

* API keys are encrypted at rest using AES-256-GCM.
* OAuth tokens are scoped to only the permissions you grant.
* You can revoke any connection at any time from **Settings → Integrations**.
* Webhook events are verified with HMAC signatures before processing.
