Google Calendar setup
Connecting Google Calendar takes one authorization. Authorize Google Calendar's MCP server and your setup gives you two things.
- Read and write calendar tools work right away. Glean and Glean agents can find, create, update, and respond to meetings, list calendars, and suggest times. Every tool runs as the person asking, using their own Google authorization, so it respects that user's Calendar permissions.
- Permission-aware search is available when you turn on data crawling and indexing. Glean indexes your Google Calendar events so meetings appear in search and power calendar agents. Glean enforces Calendar permissions at query time, and private events surface as free or busy only.
- Connect and authorizetoday — current step
- Use read and write toolstoday — current step
- Indexing runs in the backgroundtoday — happens automatically
- Permission-aware search switches ontomorrow — happens automatically
Feature availability after setup
Read and write calendar tools work as soon as you authorize the MCP connection. Search switches on once you begin indexing and the first crawl completes.
| Capability | When it becomes available | Whose permissions apply |
|---|---|---|
| Read and write calendar tools | Immediately after you authorize the MCP connection | Each user's own Google permissions, through their own Google authorization |
| Permission-aware search | Once you begin indexing and the first crawl completes | Calendar permissions enforced at query time. Private events show as free or busy |
Connector setup
Prerequisites
Confirm the following before you begin.
| Requirement | Why it is needed |
|---|---|
| A Glean admin who can add and configure connectors | Adds the Google Calendar connector and authorizes it in the Admin console |
| A Google Workspace admin | Authorizes the MCP connection and manages the shared Google Drive delegation for indexing |
| The Google Drive connector, set up and healthy | Google Calendar indexing reuses the Google Drive service account and domain-wide delegation |
Step 1. Connect
In the Glean Admin console, go to Connectors and add the Google Calendar connector. This step authorizes Google Calendar's tools.
-
Enter a Name for the connector. This is the name your organization members see.
-
Under Select an authorization method, pick one option.
- Central (recommended). Use Glean's managed OAuth app, which needs no configuration.
- Custom. Use your own Google OAuth app. You provide a Client ID and Client secret.
For Custom, always select Use this client for an AI-powered agent when creating the OAuth client in Google Cloud Console. See Create a custom OAuth client for the client setup steps.
See Google tools setup for the full instructions.
-
Select Continue. You return to Glean to set up indexing.
Step 2. Set up indexing
To add permission-aware search, set up data crawling and indexing. Google Calendar reuses the Google Drive connector's service account and delegation.
- Confirm the Google Drive connector is set up and healthy.
- Add the Calendar scope (
https://www.googleapis.com/auth/calendar.readonly) to the domain-wide delegation client that Google Drive already uses, and enable the Google Calendar API in the same Google Cloud project. - Confirm the directory admin email from the Google Drive connector is a valid Google Workspace user with Calendar enabled.
Step 3. Review and begin
Review who can use the connector and any data access rules, then finish setup. Select Begin indexing to start the crawl, or defer it and start later from the connector page.
Create a custom OAuth client
Complete these steps if you select Custom when connecting Google Calendar.
When replacing an existing OAuth client, repeat the allowlisting and verification steps for the new client ID before reconnecting.
Use this setup when your organization requires a customer-owned OAuth app instead of the Glean central app. You will create an OAuth 2.0 client in Google Cloud Console and enter the credentials in Glean.
1. Enable the Google Calendar API
- Go to the Google Cloud Console and select your project.
- Navigate to APIs & Services → Library.
- Search for and enable the Google Calendar API.
2. Enable the Calendar MCP API
- In the same project, go to APIs & Services → Library.
- Search for and enable the Google Calendar MCP API (
calendarmcp.googleapis.com).
Note: The Calendar MCP API is currently part of the Google Workspace Developer Preview Program. Your project must be enrolled in the Developer Preview to enable this API.
3. Configure the OAuth consent screen
- In the same project, go to APIs & Services → OAuth consent screen (or Google Auth Platform → Branding in newer console layouts).
- If not already configured, set the User type to Internal (recommended for organization-only access) or External (Audience page when configured).
- Fill in the required fields (app name, support email) and click Save and Continue.
- On the Data Access page, click Add or Remove Scopes and add:
https://www.googleapis.com/auth/calendar
- Click Update, then Save and Continue.
Note: This single scope covers both read and write access to Google Calendar and is used for MCP tools as well as other Google Calendar actions in Glean.
4. Create the OAuth client credentials
Always select Use this client for an AI-powered agent when creating a custom OAuth client for Glean, so you can use it with Google Workspace MCP servers in the future. If you leave it unselected, you will need to create another client to set up MCP later.
- Go to Google Auth Platform → Clients (or APIs & Services → Credentials).
- Click Create client (or Create credentials → OAuth client ID).
- For Application type, select Web application.
- Enter a Name (e.g., "Glean Calendar MCP").
- Under Authorized redirect URIs, click + Add URI and paste the Callback URL from this setup page: Copy the Callback Url from the Glean Admin Console setup panel.
- Select Use this client for an AI-powered agent.
- Click Create.
- Copy the Client ID and Client Secret — you will need them in the following steps.
5. Allowlisting your OAuth app
- Go to the Google Admin Console.
- Navigate to Security → Access and data control → API controls.
- Click Manage App Access.
- Under Configured apps, click Configure new app.
- Enter your OAuth app Client ID into the search field and click Search.
- Select your OAuth app from the search results.
- Under Scope, keep the top-level organization selected, or click Select org units → Include organizations to scope to specific OUs, then click Select.
- Click Continue.
- Under Access to Google data, choose Trusted.
- Click Continue, review the configuration, and click Finish.
Changes can take up to 24 hours to propagate, but typically take effect within a few minutes.
6. Verify your OAuth app
Return to the Configured apps list and confirm your OAuth app appears with a Trusted status.
7. Enter credentials and connect
- On this setup page, locate the Client ID and Client Secret fields under Custom app setup.
- Paste the Client ID and Client Secret from the Google Cloud Console into the matching fields.
- Click Connect to authenticate with your Google account.
Troubleshooting
-
MCP requests rejected — In Google Auth Platform → Clients, open the OAuth client used by Glean and confirm Use this client for an AI-powered agent is selected. If you cannot change the setting, create a new OAuth client with it selected, update the credentials in Glean, and reconnect. Google starts rejecting unmarked clients on November 11, 2026. Existing clients not marked by November 12, 2026 require replacement for MCP access. See Google's announcement.
-
"Access blocked" or "unverified app" error — If your OAuth consent screen is set to External and the app is not yet verified by Google, add test users under OAuth consent screen → Test users, or switch to Internal if only your organization needs access.
-
"Redirect URI mismatch" — Verify the Authorized redirect URI saved on the OAuth client in Google Cloud Console matches the Callback URL shown on this page exactly, including scheme and trailing path.
-
"Calendar MCP API not found" — Ensure your Google Cloud project is enrolled in the Google Workspace Developer Preview Program before enabling the API.
Quick checklist
- Enable the Google Calendar API in your Google Cloud project
- Enable the Google Calendar MCP API (requires Developer Preview enrollment)
- Configure the OAuth consent screen with the required scopes
- Create a Web application OAuth client with the Glean callback URL as the redirect URI
- Select Use this client for an AI-powered agent before creating the client
- Allowlist your OAuth app
- Verify your OAuth app
- Copy the Client ID and Client Secret into Glean
- Click Connect to authenticate
Manage tools
Connecting Google Calendar makes its tools available. You can see all available tools on the Tools tab of your connector and edit permissions through Advanced settings.
Tool settings you can change afterwards
- Which tools are on. Keep read tools enabled and leave write tools off until you are ready for agents to act on calendars. See Enabling or disabling individual tools.
- Where they appear. Across Glean Assistant, Agents, and the Glean MCP server. See Enabling tools for Chat and Agents.
- Who can use them. Scope each tool to specific users or groups. See Tool visibility scoping and role-based access to tools.
- How write tools run. Control whether a tool runs without user confirmation. See Run tools without user confirmation and Allowing in-line execution of write tools.
For the full guide, see Tools overview.
Per-user authorization
Setup authorizes Glean to Google Calendar at the connector level. From there, two identities decide what each person sees.
| Capability | Runs as | What it enforces |
|---|---|---|
| Indexed search | The shared Google Drive service account, through domain-wide delegation | Calendar permissions enforced at query time. Private events show as free or busy |
| Read and write tools | Each user's own Google account | That user's own Calendar permissions, checked by Google on every call |
Each teammate authorizes their own Google account over OAuth the first time they use a tool. Indexed search needs no action from end users once the crawl completes.
After setup
- Tune what is indexed with inclusion and exclusion rules for calendars.
- Check progress any time from the Google Calendar connector page in the Admin console.
See also
- Choose your Google Calendar setup shows which setup is yours and how tools and indexed search fit into each.
- Google Calendar overview covers capabilities, indexing scope, permissions, and limitations.
- Connect Google Calendar with Glean is the existing connector setup reference.