Benefits of connecting Granola to Windmill
Connecting Granola to Windmill brings your meeting notes and transcripts into Windy’s context — so nothing from your conversations gets lost.- Granola recordings appear linked to their matching 1:1 in Windmill
- Windy has access to every Granola meeting visible to your connection — notes you own, notes shared with you, and anything in folders you can see
- Richer Catch Me Up reports that can cite real meeting content
- Meeting context surfaces in suggested topics and performance reviews
- Discussions and decisions get captured as they happen, not months later
Granola content is used as context for Windy — it is not automatically imported into your 1:1 notes. See Where Granola content shows up for the full picture.
How to connect Granola
1
Generate an API key in Granola
In Granola, go to Settings → Connectors → API keys. Click Create new key, then choose the note access scopes for the key. The Personal notes scope is all the Windmill sync needs. See API Key Types below for details on each option.
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. If a workspace admin created the key for the whole workspace, select Workspace API key.
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.
When you first connect Granola, the initial full sync uses the previous six months. Source retention and permissions can limit the recordings that Windmill receives. Newer recordings continue syncing every hour.
API key types
Granola API keys created by workspace members carry one or more access scopes — Personal notes and Public notes. Workspace admins can also create workspace API keys that belong to the workspace rather than a user. The key you choose affects who can see the synced recordings in Windmill. The scopes on a key only control which notes sync from Granola. They never change who can see the data in Windmill.Personal API key
- Any workspace member on a Granola Business plan can create API keys. On Enterprise plans, a workspace admin must first enable the scopes under Settings → Workspace → General → “API access for members”.
- Accesses notes you own or that are shared with you — including notes in private folders shared with you. Create the key with the Personal notes scope. Adding Public notes also syncs every public note in your workspace into your private view.
- 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
Workspace API key
- Created by workspace admins on Business and Enterprise plans. The key belongs to the workspace, survives the creator leaving, and does not expire.
- Reads the workspace’s public notes plus any spaces that have been granted Granola API access (Allow Granola API access is on by default for new spaces) — cannot access private notes
- In Windmill, each recording synced through a Workspace key is visible only to the recording’s owner (if they’re a Windmill member). It is not visible to anyone else, even if the note was shared with them in Granola.
Granola’s API doesn’t expose who a note has been shared with, so Windmill can’t reliably tell which other users should have access. To avoid leaking recordings to people who shouldn’t see them, Windmill restricts visibility to the recording’s owner only.If you want everyone to see the recordings they have access to in Granola, have each user connect with their own Personal API key instead.
Connected data
When Granola is connected, Windmill securely reads the following information:
Granola data syncs into Windmill’s Recording data model, making it available to Windy and linkable from 1:1s and performance reviews.
Where Granola content shows up in Windmill
Granola content flows into Windmill in three distinct places. It helps to keep these separate — they behave differently.Linked recordings on 1:1s
When a Granola recording matches a 1:1, Windmill shows the recording as a link on that 1:1. Clicking it opens the notes and transcript. Windmill matches recordings to 1:1s using two methods:- Calendar event matching — Windmill links recordings based on the underlying calendar event ID. This is the primary method and works when both Granola and Windmill are connected to the same calendar.
- Smart fallback — If a calendar event ID isn’t available, Windmill uses the meeting time and attendees to identify the correct 1:1.
The link appears for whoever connected Granola and has access to the recording. If both the manager and their direct report want to see the recording on the 1:1, both need to connect Granola and the recording needs to be shared in Granola (see Sharing recordings across users).
Catch Me Up reports
Catch Me Up reports get you up to speed ahead of a 1:1. Learn more in 1:1s → Catch Me Up. If you’ve connected Granola, Granola notes can surface as a source in Catch Me Up — but it’s not guaranteed:- Catch Me Up is dynamic. Content is pulled from available sources each time the report is generated.
- A Granola recording will only be considered if it existed when the report was generated. Recordings from meetings that happened after the last generation won’t appear until the report regenerates.
- You can click Regenerate on the Catch Me Up panel to re-run it with the latest data.
- Only your own Granola connection is used. The other person’s Granola auth has no effect on what appears in your Catch Me Up.
Granola will not automatically populate the shared 1:1 notes space
Granola notes are not copied or imported into the shared 1:1 notes section. The 1:1 notes space is for what you and your counterpart write together in Windmill — it stays separate from the Granola recording linked above. If you want to pull Granola content into your 1:1 notes, you can copy and paste it manually.To land Granola content inside the shared 1:1 agenda, use Import Granola Notes (per-1:1, takes a share link) or Import 1:1 Notes (on an employee profile, paste past text). Both are separate from this integration — see Importing notes to 1:1s.
Windy
Windy has access to every Granola meeting visible to your connection — notes you own, notes shared with you, and anything in folders you can see. You can ask Windy about past meetings, decisions, or context, and Windy can cite Granola recordings in its responses. This applies to all Granola recordings, including non-meeting recordings (dictation, brainstorming, solo notes). Those still sync and are available to Windy — they just won’t be matched to a specific 1:1.Windmill syncs with Granola once per hour. New recordings may take up to an hour to appear.
Sharing recordings across users
Granola recordings are private to the person who recorded them by default. For a recording to be visible to both people in Windmill:- The recording must be shared in Granola — either moved into a shared folder, or recorded directly into one.
- Both people must connect Granola to Windmill with their own Personal API key.
Permissions
Windmill requests read-only access to Granola.FAQs
Does Windmill change anything in Granola?
Does Windmill change anything in Granola?
No. Windmill is 100% read-only. It never creates, modifies, or deletes recordings, notes, or any other data in Granola.
How often does Granola data sync?
How often does Granola data sync?
Windmill syncs with Granola once per hour. New recordings can appear after the next hourly sync. When you first connect, the initial full sync uses the previous six months.
What's the difference between Personal and Workspace API keys?
What's the difference between Personal and Workspace API keys?
Personal API keys are created by workspace members. With the Personal notes scope, they sync notes you own, notes shared with you, and private folders shared with you. All synced data is private to you in Windmill. Any member on a Business plan can create one; on Enterprise plans, a workspace admin must first enable API access for members.Workspace API keys are created by workspace admins on Business and Enterprise plans. They belong to the workspace, don’t expire, and sync the workspace’s public notes plus any spaces with Granola API access enabled — never private notes. In Windmill, each recording is visible only to its owner in Granola.See API Key Types for full details.
Can multiple people connect their own Granola accounts?
Can multiple people connect their own Granola accounts?
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.
Why can't I see all my Granola recordings in Windmill?
Why can't I see all my Granola recordings in Windmill?
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 a Workspace key, each recording is only visible to its owner in Granola — even if the note was shared with you. If you’re missing recordings you have access to in Granola, try creating your own Personal connection.
I can't create a personal API key in Granola
I can't create a personal API key in Granola
On Granola Enterprise plans, a workspace admin must first enable API access for members. Ask your admin to go to Settings → Workspace → General, select Manage under “API access for members,” and enable the Personal notes scope. That scope is all the Windmill sync needs. After the admin enables it, create your key under Settings → Connectors → API keys.
Which access scope does my API key need?
Which access scope does my API key need?
The Windmill sync needs note-read access — the Personal notes scope is sufficient. Public notes is optional and adds workspace-public notes to your private view. A key with no note-read scope fails to connect with the generic “Invalid Granola API key” error.
Why don't I see my Granola notes inside my 1:1 notes?
Why don't I see my Granola notes inside my 1:1 notes?
Granola content isn’t copied into the shared 1:1 notes section — that space is for what you and your counterpart write together. Granola recordings show up as a link on the 1:1 instead. If you want the Granola content in your notes, copy and paste it in.
Will my Granola recording show up in someone else's Catch Me Up?
Will my Granola recording show up in someone else's Catch Me Up?
It can, but it’s not guaranteed. Catch Me Up only considers Granola recordings that existed when the report was generated, and only pulls them in when relevant. If a recent meeting isn’t showing up, the person generating the report can click Regenerate on the Catch Me Up panel. Only that person’s own Granola connection feeds their Catch Me Up — your personal Granola auth doesn’t change what appears there.
Does Windy have access to all my Granola meetings?
Does Windy have access to all my Granola meetings?
Yes — Windy has access to every Granola meeting visible to your connection, including notes you own, notes shared with you, and anything in folders you can see. You can ask Windy about past meetings and it can cite Granola as a source.
Can both a manager and their direct report see the same Granola recording on a 1:1?
Can both a manager and their direct report see the same Granola recording on a 1:1?
Yes, but two things need to be true: the recording has to be shared in Granola (moved to or recorded in a shared folder), and both people need to connect Granola to Windmill with their own Personal API key. Without both, the recording will only appear for the person whose Granola connection has access to it.
What happens to recordings that aren't part of a meeting?
What happens to recordings that aren't part of a meeting?
They still sync into Windmill and are available to Windy. They just won’t be matched to a specific 1:1.