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

# How to set up integrations

> How to connect external services to Freshbase to supercharge your workflow.

By the end of this guide, you will know how to connect external services to Freshbase to supercharge your workflow.

## Accessing integrations

1. Click **Settings** in the sidebar
2. Click **Integrations** in the sidebar

## Available integrations

### Google Calendar

Syncs your meetings to make invites and transcriptions easier.

**How to connect:**

1. In **Integrations**, find **Google Calendar**
2. Click **Connect Google Calendar**
3. A Google window will open — authorize access
4. After authorizing, the status changes to **Connected**

**What happens next:**

* Freshbase can suggest calendar contacts when inviting members
* Calendar meetings can appear in the **Meetings > Upcoming** section
* Makes automatic transcription creation easier

**To disconnect:** Click **Disconnect** in the Google Calendar section.

**To reconnect:** If the connection expires, click **Reconnect Google Calendar**.

### Linear

Integrates with Linear to create and sync development tasks.

**How to connect:**

<Steps>
  <Step title="Find">In **Integrations**, find **Linear**</Step>
  <Step title="Connect">Click **Connect Linear**</Step>
  <Step title="API Key">Generate a personal API Key in Linear settings and copy it</Step>
  <Step title="Paste">Paste the API Key in the corresponding field</Step>
  <Step title="Test">Click **Test** to verify the connection</Step>
  <Step title="Save">Click **Save**</Step>
</Steps>

**What happens next:**

* You can create issues in Linear directly from Chat
* Tasks extracted from meetings can be sent to Linear
* The assistant can search and reference existing issues

### Transcription upload

Allows importing transcriptions from external tools.

**Accepted formats:**

* Granola
* Fireflies
* Tactiq
* Notes (generic format)

No special configuration required — just upload in the **Meetings** section.

## Advanced integrations

### MCP Keys (Claude Code)

If you use Claude Code and want to connect it to your Base:

1. Go to **Settings > Security > MCP Key**
2. Click **New MCP Key**
3. Select the **linked Base**
4. Give the key a **name** (optional)
5. Click **Generate key**
6. **Copy the key immediately** — it is only shown once

Each MCP Key:

* Is linked to a specific Base
* Can be revoked individually in **Settings > Security**
* Shows when it was created and last used

### Fireflies.ai (webhook)

To automatically receive transcriptions from Fireflies:

1. In Fireflies, configure a webhook pointing to your Freshbase instance
2. When a meeting is processed in Fireflies, the transcription arrives automatically
3. Freshbase processes it and generates items in the Inbox

## All integrations are optional

No integration is required to use Freshbase. You can configure them at any time in **Settings > Integrations**. The onboarding flow also reminds you of available integrations in the final step.

## Common issues

<AccordionGroup>
  <Accordion title="Google Calendar is not configured in the server environment">
    This message appears when the server environment doesn't have Google Calendar credentials configured. Contact your instance administrator.
  </Accordion>

  <Accordion title="I can't test the connection with Linear">
    Check that the API Key is correct and has sufficient permissions. Generate a new key in Linear if needed.
  </Accordion>

  <Accordion title="I lost my MCP Key">
    MCP Keys are only displayed once. If you lost it, revoke the old key and generate a new one.
  </Accordion>
</AccordionGroup>

<Card title="Next step" icon="arrow-right" href="/personas/product-owner">
  Explore the persona guides
</Card>