Skip to main content

Benefits of Connecting Granola to Windmill

Connecting Granola to Windmill brings your AI-powered meeting notes directly into 1:1s, performance reviews, and recaps — so nothing from your conversations gets lost.
  • Meeting notes and transcripts automatically flow into 1:1 prep and suggested topics
  • Windy uses recordings you have access to in Granola to generate analytics and insights about your work
  • Managers get richer catch me up reports grounded in real meeting context
  • Meeting content surfaces in performance reviews and recaps without manual copying
  • Captures discussions and decisions as they happen, not months later
Windmill turns the Granola recordings you have access to into structured, actionable context across your entire performance workflow.

How to Connect Granola

1

Generate an API key in Granola

In Granola, go to Connectors > API in the sidebar. Click Create new key, then select either Personal API or Enterprise API depending on your use case. See API Key Types below for details on each option.
Granola's Generate API Key dialog showing Personal API and Enterprise API options
2

Open the Connect Granola page in Windmill

In Windmill, navigate to Settings > Integrations, find Granola, and click Connect. Select the key type that matches the key you generated in Granola.
Windmill's Connect Granola page with key type selection and API key input
3

Paste your API key and connect

Paste the API key from Granola into the input field and click Connect Granola. Recordings you have access to in Granola will begin syncing within the hour.

API Key Types

Granola supports two types of API keys, each with different access levels. The key type you choose affects who can see the synced recordings in Windmill.

Personal API Key

  • Available to all Granola users (currently in Beta)
  • Syncs recordings you have access to in Granola — including notes you own, notes directly shared with you, and notes in private folders shared with you
  • In Windmill, all data synced through a Personal API key is private to the user who created the connection — no one else can see it
We recommend that each Granola user creates their own Personal connection. This is the best way to ensure everyone has access to the recordings available to them in Granola.

Enterprise API Key

  • Available to enterprise admins only (requires a Granola enterprise plan)
  • Accesses all notes in your Granola “Team space” — cannot access private notes
  • In Windmill, data synced through an Enterprise key is visible only to the owner of the note in Granola (if they’re a Windmill member)
Granola’s API does not provide full access control lists for recordings. Because of this, Windmill limits visibility to the identities it can confirm have access — ensuring no one sees recordings they shouldn’t.

Connected Data

When Granola is connected, Windmill securely reads the following information:
Data TypeHow Windmill Uses It
Meeting notes and summariesSurfaces in 1:1 agendas, suggested topics, and catch me up reports
TranscriptsPowers Windy’s analytics and insights on your work
Recording metadataMatches recordings to calendar events for 1:1 sync
Granola data syncs into Windmill’s Recording data model, making it available across 1:1s, recaps, performance reviews, and Windy.

How Recordings Connect to 1:1s

Windmill automatically matches Granola recordings you have access to with the right 1:1s using two methods:
  1. Calendar event matching — Windmill links recordings to 1:1s based on the underlying calendar event ID. This is the primary matching method and works when both Granola and Windmill are connected to the same calendar.
  2. Smart fallback — If a calendar event ID isn’t available, Windmill uses the meeting time and attendees to identify the correct 1:1.
Once a recording is matched, its notes are copied into the 1:1 page. You can edit the imported notes just like any other 1:1 content — edits in Windmill won’t affect the original recording in Granola. Not all Granola recordings are tied to meetings. If you use Granola for dictation, brainstorming, or other non-meeting recordings, those still sync and are available to Windy — they just won’t appear in a specific 1:1.
Windmill syncs with Granola once per hour. New recordings may take up to an hour to appear.

Permissions

Windmill requests read-only access to Granola.
PermissionPurpose
Read recording dataTo sync meeting notes, transcripts, and metadata into Windmill
Read-only accessWindmill never creates, modifies, or deletes anything in Granola
One-way syncData flows from Granola to Windmill only — nothing is written back
Access scoped by keyVisibility in Windmill depends on the API key type used to connect

FAQs

No. Windmill is 100% read-only. It never creates, modifies, or deletes recordings, notes, or any other data in Granola.
Windmill syncs with Granola once per hour. New recordings will appear within an hour of being created in Granola.
Personal API keys are available to all Granola users and sync recordings you have access to in Granola — including notes you own or that are shared with you. All synced data is private to you in Windmill.Enterprise API keys are available to Granola enterprise admins and sync all Team space notes. In Windmill, each recording is visible only to its owner in Granola.See API Key Types for full details.
Yes — and we recommend it. Each person should create their own connection using a Personal API key. This is the only way to ensure everyone has access to the recordings available to them in Granola.
Visibility depends on which API key type was used to connect. With a Personal API key, only you can see the recordings synced through your connection. With an Enterprise key, only the note owner in Granola can see each recording. If you’re missing recordings you have access to in Granola, try creating your own Personal connection.
Yes. When Granola notes are imported into a 1:1, they’re copied into the page. You can edit them freely — your changes won’t affect the original recording in Granola.
They still sync into Windmill as recordings and are available to Windy for analytics and insights. They just won’t be matched to a specific 1:1.