Skip to main content

​
Benefits of Connecting Google Workspace to Windmill

Connecting Google Workspace to Windmill ensures that written work, collaboration, planning, and meeting participation are recognized automatically — without employees needing to manually summarize what they contributed.
  • Surfaces real project contributions from Docs, Drive, and Calendar
  • Ensures employees get credit for behind-the-scenes thinking and collaboration
  • Helps managers remember what happened across the year, not just recently
  • Reduces time spent preparing for performance reviews and 1:1s
  • Enables the use of Windmill’s 1:1 feature
  • Makes evaluations more fair, consistent, and based on real work
Windmill turns ongoing collaboration in Google Workspace into structured, continuous performance context. Google Workspace is a suite of cloud-based productivity tools that includes Gmail, Google Drive, and Google Meet.

​
Installation

You can connect your Google Workspace to Windmill - follow these easy steps here:

​
Step 1. Open Google Admin Console

Open your Google Admin Console and navigate to Security → API Controls → Domain-wide Delegation. We will provide you with a link to access this directly.

​
Step 2. Authorize Client ID

Under API Clients, click “Add New,” enter the details below, and click “Authorize.” We will provide you with a Client ID to provide here. Copy any scopes you’d like to integrate. We’ve provided a “Copy Scopes” button as well to give you easy access to copying them all over. The scopes that we recommend are: Here are the Google OAuth Scopes required by the Windmill (Windy) App:
OAuth ScopeDescription
https://www.googleapis.com/auth/userinfo.emailLets Windy access the user’s email address
https://www.googleapis.com/auth/admin.directory.user.readonlyLets Windy view details about users in the directory
https://www.googleapis.com/auth/calendar.readonlyLets Windy view the user’s calendars
https://www.googleapis.com/auth/calendar.events.readonlyLets Windy view events on the user’s calendars
https://www.googleapis.com/auth/calendar.settings.readonlyLets Windy view calendar settings for the user
https://www.googleapis.com/auth/drive.activity.readonlyLets Windy view recent activity in the user’s Google Drive
https://www.googleapis.com/auth/drive.readonlyLets Windy view files and folders in the user’s Google Drive
https://www.googleapis.com/auth/meetings.space.readonlyLets Windy view meeting spaces and related information in Google Meet
https://www.googleapis.com/auth/admin.directory.group.member.readonlyLets Windy view group members in the directory
https://www.googleapis.com/auth/admin.directory.group.readonlyLets Windy view groups in the directory

​
Step 3. Enter Workspace Details

After the API Client has been added enter the email of a Super Admin on your google workspace. Select “Connect your Workspace” and you’re off to the races.

​
Connected Data

Connecting Google gives Windmill access to the following scopes:
  • userinfo.email – Lets Windy access the user’s email address
  • user.readonly – Lets Windy view details about users in the directory
  • calendar.readonly – Lets Windy view the user’s calendars
  • calendar.events.readonly – Lets Windy view events on the user’s calendars
  • calendar.settings.readonly – Lets Windy view calendar settings for the user
  • drive.activity.readonly – Lets Windy view recent activity in the user’s Google Drive
  • drive.readonly – Lets Windy view files and folders in the user’s Google Drive
  • meetings.space.readonly – Lets Windy view meeting spaces and related information in Google Meet
  • admin.directory.group.member.readonly – Lets Windy view group members in the directory
  • admin.directory.group.readonly – Lets Windy view groups in the directory
Within setup, Admins have the option to edit this list of scopes.

​
Permissions

You need to be a Google Workspace Admin to connect Google.

​
FAQs

The super admin email is required to access Google’s administrative APIs that only super admins can use:
  • Employee Directory - We need admin access to sync all employees in your workspace
  • Groups - Only admins can retrieve group memberships and organizational structure
  • Domain-wide Access - Admin privileges let us sync data for all users, not just individuals
Without super admin access, we can’t retrieve your company’s employee list or team structures from Google Workspace.