Skip to main content

​
Benefits of connecting Notion to Windmill

Connecting Notion to Windmill ensures planning, documentation, and project work becomes visible in performance conversations — without employees needing to summarize or translate their work manually.
  • Automatically captures contributions to docs, specs, research, and project planning
  • Recognizes the invisible but critical thinking work that often gets missed in reviews
  • Reduces the time managers and employees spend preparing for review cycles
  • Helps managers coach using real examples of communication, clarity, and collaboration
  • Makes performance reviews more fair and grounded in the full scope of someone’s work
Windmill turns ongoing Notion activity into meaningful context for reflection, coaching, and evaluation.

​
Connection types

When connecting Notion to Windmill, you’ll choose between two connection types. The setup flow is the same for both — the difference is who can see the synced data.

​
Account

An account connection is set up on behalf of your organization. Any data synced from this integration is globally available to all Windmill members in your company. This is ideal when your team uses shared Notion workspaces and you want everyone to benefit from the synced context.
Only Admins, HR Admins, and Integration Managers can create account connections.

​
Personal

A personal connection is tied to an individual. Any data synced from this integration is only visible to you — no one else in your Windmill organization can see it. This is a good option if you want to connect personal Notion pages or private notes without sharing them across your team.
Any Windmill member can create a personal connection, as long as their Notion workspace allows them to add or use the Windmill connection.

​
Choosing a connection type

AccountPersonal
Who can create itAdmins onlyAny member
Data visibilityAll Windmill membersOnly you
Best forShared workspaces, team docs, project pagesPrivate notes, personal pages

​
Notion Enterprise workspace settings

Some Notion Enterprise workspaces restrict which integrations members can add. Notion calls integrations connections in its settings. If a member sees an error while creating a personal Notion connection in Windmill, the fix is usually in Notion’s Enterprise connection settings.
Start setup from Windmill, not from Notion. Installing Windmill from Notion alone may add the connection to the workspace, but each Windmill member still needs to finish the Personal setup flow in Windmill.
For personal Windmill setup, check the Member tab in Notion’s connection settings. The Workspace tab is for Notion’s workspace-wide security and compliance integrations.

​
Approving Windmill for members

A Notion workspace owner can approve Windmill for members without making every member a workspace owner.
1

Open Notion connection settings

In Notion, go to Settings → Connections.
2

Check member restrictions

Open the Member tab and check Restrict members from adding connections.If this is set to No restrictions, members should be able to connect Windmill from Windmill. If this is set to Only from approved list, Windmill needs to be approved first.
3

Install Windmill once if needed

If Windmill does not appear in the approved connection dropdown, a Notion workspace owner needs to install Windmill once first.The owner should go to Settings → Integrations in Windmill, select Notion, and complete either an Account connection or their own Personal connection.
4

Add Windmill to the approved list

Back in Notion, go to Settings → Connections → Member and add Windmill to the approved connections list. Installing Windmill is not always enough on its own; members can still be blocked until Windmill is approved here.
5

Ask members to connect from Windmill

Members can now return to Windmill, choose Notion, select Personal, and approve access to the pages they want to share.

​
Managing page access in Enterprise workspaces

Notion Enterprise workspace owners can also control who is allowed to connect or disconnect integrations from specific pages. If Windmill is approved but a member still cannot select or share pages, check page access settings in Notion.
1

Open the Windmill connection in Notion

In Notion, go to Settings → Connections → Member.
2

Open page access settings

Click the ••• menu next to Windmill, then select Manage page access.
3

Choose pages and who can manage them

Under Select pages, choose the pages Windmill can access. Under Who can manage page access, choose whether members can manage page access themselves or only workspace owners can.
If members should be able to manage their own personal page selections, set page access management to the default member-access option. If your Notion owner keeps this restricted to workspace owners, the owner will need to manage Windmill page access for members. For more detail, see Notion’s help docs for Enterprise connection settings and adding and managing connections.

​
Setting up the Notion integration

1

Go to Integrations

Navigate to Integrations in your Windmill settings.
2

Select Notion

Find Notion in the list of available integrations and click Connect.
3

Choose your connection type

Select Account to connect on behalf of your organization, or Personal to connect your own account.
4

Approve access in Notion

You’ll be redirected to Notion to approve access for Windmill.Notion permissions screen showing the access Windmill requestsWindmill will request permission to:
  • View pages you select
  • View comments within pages you select
  • View workspace users and their emails
Click Select pages to move forward.
5

Choose which pages to share

Select the pages you’d like Windmill to access. Windmill will only ever see the pages you select here, plus any subpages nested inside them — nothing else in your workspace.Notion page selection screen for choosing which pages to shareFrom here, you can:
  • Browse your Teamspaces and Private sections
  • Select all or Deselect all pages at once
  • Use the search bar to quickly find specific pages
  • Expand folders to include or exclude subpages
Selecting a parent page also shares the subpages nested inside it, including ones you add later. New top-level pages aren’t added automatically — you can share those at any time (see Managing visibility and access).
After you’ve made your selections, click Allow access to complete setup.

​
How Page Access Works

Windmill’s access to your Notion workspace is a point-in-time selection. When you connect, you choose which pages to share — and from then on, Windmill can only see those pages and the subpages nested inside them. Nothing else in your workspace is visible. This has a few important implications:
  • New pages aren’t shared automatically. A page you create later won’t sync on its own. The one exception is subpages: a page created inside a page you already shared inherits that access automatically.
  • A teamspace doesn’t grow your access. Selecting pages from a teamspace shares the pages that exist at that moment — not the teamspace itself. New top-level pages added to it later won’t sync until you share them.
  • Unselected pages stay private. Any page you didn’t select stays invisible to Windmill, even if you have access to it yourself in Notion.
  • You stay in control. You can add or remove shared pages at any time — see Managing visibility and access below.
To share a whole branch of your workspace, select its top-level page in the picker — every subpage inside it is included, now and as you add more. Just remember this works for pages, not teamspaces.

​
Managing Visibility and Access

Because access is set when you connect, you’ll need to update it whenever you want Windmill to see more (or fewer) pages. There are two ways to do this.

​
From Windmill

Go to Settings → Integrations → Notion → Manage access. From here, you can:
  • Reconnect to Notion if access expires
  • Reopen the Notion page picker to see which pages are currently selected and add or remove shared pages
  • Disconnect the integration entirely

​
From Notion

You can also share a single page with Windmill directly inside Notion:
  1. Open the page and click the ••• menu in the top-right corner.
  2. Click Add connections, then select Windmill.
To stop sharing a page, open the same ••• menu, hover over Windmill under connections, and click Disconnect.
If a member with a personal connection is archived, their personal Notion connection is automatically removed.

​
Meeting notes and transcripts

If your Notion pages include AI-generated meeting notes, Windmill pulls in the summary of the meeting on demand when Windy references that page — but not the raw transcript.
  • Windy can see the meeting title, date, summary, and any notes written on the page
  • The full transcript itself is not synced or stored in Windmill
  • Meeting notes pulled from Notion are not linked to 1:1s in Windmill
If your team relies on transcripts being available in Windmill (for example, to power 1:1 recaps or review context), connect a dedicated meeting source such as Zoom, Google Meet, Granola, or Gong instead of relying on Notion.

​
Best practices

  • Share only pages relevant to your team’s use of Windmill (e.g., meeting notes, team goals, or planning docs).
  • Share a parent page to automatically include the subpages within it. New top-level pages — including ones added to a teamspace later — must be shared manually.
  • Use an account connection for shared team workspaces so all members benefit from the context.
  • Use a personal connection for private notes or pages you don’t want visible to others.
  • Revisit your integration settings if your Notion workspace structure changes.
  • Keep sensitive or unrelated pages unselected to maintain privacy and data security.

​
FAQs

Yes. An admin can set up an account connection for shared workspaces, and individual members can also create their own personal connections for private pages. The two work independently.
An account connection syncs data that’s visible to all Windmill members in your organization. A personal connection syncs data that’s only visible to you. The setup process is the same for both — the difference is who can see the synced data.
Only Admins, HR Admins, and Integration Managers can create account connections. Any Windmill member can create a personal connection, as long as their Notion workspace allows them to add or use the Windmill connection.
Ask a Notion workspace owner to approve Windmill in Settings → Connections → Member. If Windmill is not available in the approved connection dropdown yet, the workspace owner needs to install Windmill once from Windmill first. After Windmill is installed and approved, members can connect their own personal Notion accounts from Windmill.
No. On Notion Enterprise, a workspace owner can keep member restrictions enabled and add Windmill to the approved connections list. Members can then create personal Windmill connections without being promoted to workspace owner.
Check two Notion settings. First, confirm Windmill appears under Settings → Connections → Member → Approved connections. Second, open the ••• menu next to Windmill and check Manage page access. If page access management is restricted to workspace owners, members may not be able to select or update pages themselves.
When a member is archived in Windmill, their personal Notion connection is automatically removed and the associated data is no longer accessible.
Only if the new page lives inside a page you already shared — subpages inherit their parent’s access. A new top-level page stays invisible to Windmill until you share it, even if it’s in a teamspace you’ve already pulled pages from. Windmill’s access reflects the pages you selected when you connected, not your whole workspace.
Two ways. In Windmill, go to Settings → Integrations → Notion → Manage access and reopen the page picker. Or, in Notion, open the page, click the ••• menu, choose Add connections, and select Windmill.
In Windmill, go to Settings → Integrations → Notion → Manage access and reopen the Notion page picker. The picker shows which pages are currently selected, and you can add or remove pages from there.
Deselect it in Manage access in Windmill, or open the page’s ••• menu in Notion, hover over Windmill, and click Disconnect. Windmill stops seeing that page right away.