Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hearflow.io/llms.txt

Use this file to discover all available pages before exploring further.

Connect Granola to pull AI-generated meeting notes, summaries, and transcripts into Hearflow.

Connect Granola

Open Hearflow settings to connect your Granola workspace.

​
Prerequisites

  • A Granola account with the desktop app installed
  • A Granola API key (created from the desktop app)

​
Connecting Granola

1

Generate a Granola API key

Open the Granola desktop app, go to Settings → API, click Create new key, and copy the value to your clipboard. Granola API keys start with grn_.
2

Open Hearflow integrations

In Hearflow, go to Settings → Integrations and select Granola.
3

Paste the key

Paste your API key in the secure input and click Connect. Hearflow validates the key immediately and starts a backfill if it succeeds.
Key handling — Granola keys are encrypted at rest with AES-256. They are only decrypted inside the worker process that polls Granola and never exposed in the UI after saving.

​
How it works

Backfill

Recent Granola notes are pulled when you first connect, including their summaries and transcripts.

Incremental sync

New notes are polled on a schedule and processed automatically as they are created.

Scope

Hearflow reads notes, summaries, and transcripts only. Audio recordings are never downloaded.

​
Data access and privacy

What we access
  • Note metadata (title, owner, created and updated timestamps, web URL)
  • AI-generated summaries
  • Speaker-labeled meeting transcripts
  • Calendar event details linked to the note (invitees, organizer, attendees)
  • Folder membership for the note
What we do not access
  • Audio recordings
  • Notes that belong to other Granola workspaces

​
Rate limits

Hearflow respects Granola’s published rate limits and stays well under them by default:
  • Burst: up to 25 requests per 5 seconds
  • Sustained: up to 5 requests per second per workspace
If you hit a rate limit, Hearflow automatically retries with backoff.

​
Disconnecting Granola

1

In Hearflow

Navigate to Settings → Integrations and click Disconnect next to Granola. This deletes the stored API key and stops all future syncs.
2

In Granola

For full revocation, open the Granola desktop app’s Settings → API and delete the key you generated for Hearflow.
What happens when you disconnect — Syncing stops immediately. Insights already extracted remain in Hearflow. To delete them, contact [email protected].

​
Troubleshooting

Make sure the key you pasted starts with grn_. If it does, regenerate the key in the Granola desktop app under Settings → API and paste the new value into Hearflow. Keys can be rotated without losing already-ingested notes.
Granola only returns transcripts after a meeting note has been finalized. If a recent meeting is not yet visible, wait a few minutes and try again.

​
Need help?

Contact [email protected] and we’ll help you get set up.