Google Workspace

Built by Runlayer. Runlayer builds and maintains this connector. It runs on Runlayer Deploy, which must be enabled for your workspace.

Connect your AI assistant to Google Workspace services. All Google servers share the same Google OAuth setup process.

Server	Description
Google Calendar	Manage events, calendars, and schedules
Gmail	Read, search, send emails, and manage labels
Google Drive	Browse, search, and manage files and folders
Google Docs	Create, read, and edit documents
Google Sheets	Create and manage spreadsheets
Google Slides	Create and edit presentations
Google Forms	Create, edit, and manage forms; access forms and their responses

Available Tools

Google Calendar

Tool	Description
`list_calendars`	List all accessible calendars
`list_events`	List events with date filtering
`get_event`	Get event details
`create_event`	Create an event with attendees and recurrence
`quick_add`	Create event from natural language
`update_event`	Modify an event
`respond_to_event`	Respond to an invitation (accept, decline, or tentative)
`delete_event`	Remove an event
`move_event`	Move event to different calendar
`create_calendar`	Create a new calendar
`update_calendar`	Modify calendar settings
`delete_calendar`	Remove a calendar
`get_free_busy`	Check availability

Gmail

Tool	Description
`search`	Search emails using Gmail operators
`list_messages`	List recent messages
`fetch_message`	Get full email content (includes attachment metadata)
`fetch_attachment`	Download a message attachment as text or base64
`send_email`	Send a new email (supports attachments)
`reply_to_message`	Reply to an email thread (supports attachments)
`create_draft`	Create a draft (supports attachments)
`send_draft`	Send an existing draft
`list_drafts`	List all drafts
`list_labels`	List all labels
`add_labels`	Add labels to messages
`remove_labels`	Remove labels from messages
`create_label`	Create a new label
`mark_as_read`	Mark messages as read
`mark_as_unread`	Mark messages as unread
`archive_messages`	Archive messages

Google Drive

Tool	Description
`search`	Search files by name or content; name matches ranked first
`list_folder`	List folder contents
`get_metadata`	Get file/folder metadata
`fetch_file`	Download file content
`create_file`	Create a new file
`create_folder`	Create a new folder
`create_doc_from_markdown`	Create Google Doc from Markdown
`update_file`	Update file content
`update_doc_from_markdown`	Update Google Doc from Markdown
`rename_file`	Rename a file or folder
`copy_file`	Copy a file
`move_file`	Move a file
`delete_file`	Move file to trash
`share_file`	Share a file
`list_permissions`	List sharing permissions

Google Docs

Tool	Description
`search`	Search for documents
`fetch`	Get document content
`create_file`	Create a new document from markdown or HTML
`replace_file_content`	Overwrite a document’s entire content
`insert_text`	Insert text at position
`replace_text`	Find and replace text
`delete_text`	Delete text in range
`apply_doc_updates`	Apply raw Google Docs API requests in one batch
`format_text`	Find text and apply character formatting (bold, color, font, etc.)
`format_paragraphs`	Find text and apply paragraph styling (heading, alignment, indent)
`link_text`	Find text and turn it into a hyperlink
`edit_table`	Edit a table (insert/delete rows & columns, set cell text, overwrite a whole row, column width, cell styling including padding), located by index or text
`insert_break`	Insert a page or section break
`add_comment`	Add a comment
`list_comments`	List comments on a document
`resolve_comment`	Resolve a comment
`list_tabs`	List document tabs
`fetch_tab`	Get content of a tab
`fetch_all_tabs`	Get all tab contents

Google Sheets

Tool	Description
`search`	Search for spreadsheets
`list`	List spreadsheets
`fetch`	Get spreadsheet data (values or underlying formulas)
`create`	Create a new spreadsheet
`update`	Update cell values
`update_ranges`	Update multiple ranges in a single call
`append`	Append rows
`insert_rows`	Insert blank rows mid-sheet, shifting existing rows down
`delete_rows`	Delete rows, shifting rows below up
`clear`	Clear values in a range, keeping rows and formatting
`add_sheet`	Add a new sheet tab
`get_metadata`	Get spreadsheet metadata
`set_row_visibility`	Hide or unhide rows
`group_rows`	Group rows (optionally collapsed)
`ungroup_rows`	Remove a row group
`autofill`	Extend a formula/series across a range
`format_cells`	Apply cell formatting (number format, font, color, alignment, wrap)

Google Slides

Tool	Description
`search`	Search presentations by name or content; name matches ranked first
`fetch`	Get presentation content
`list_slides`	List all slides
`get_slide`	Get slide details
`list_layouts`	List available layouts
`create`	Create a presentation
`create_from_markdown`	Create slides from Markdown
`create_from_template`	Copy a themed template deck (optionally clearing sample slides)
`duplicate`	Duplicate a presentation
`add_slide`	Add a new slide
`delete_slide`	Remove a slide
`duplicate_slide`	Duplicate a slide
`reorder_slide`	Change slide order
`add_text`	Add a text box
`update_text`	Modify text in a shape
`add_shape`	Add a shape
`add_image`	Insert an image
`add_table`	Insert a table
`add_line`	Add a line
`delete_element`	Remove an element
`style_text`	Apply text formatting
`set_paragraph_style`	Set paragraph alignment
`style_shape_advanced`	Apply shape styling
`set_slide_background`	Change background
`set_speaker_notes`	Add speaker notes

Google Forms

Tool	Description
`search`	Search for forms
`list`	List all forms
`get`	Get form structure and questions
`responses`	Get form responses
`create`	Create a new form (title only; add content with `batch_update`)
`batch_update`	Add, edit, reorder, or delete questions/items; update form info or settings

Setup

Create Google Cloud Project

Go to Google Cloud Console
Create a new project or select an existing one

Enable APIs

Go to APIs & Services > Library and enable the APIs you need:

Google Calendar API
Gmail API
Google Drive API
Google Docs API
Google Sheets API
Google Slides API
Google Forms API

Configure OAuth Consent Screen

Go to APIs & Services > OAuth consent screen
Select External or Internal
Fill in app name, support email, and developer contact
Add required scopes (see below)
Add test users if using External mode

Create OAuth Credentials

Go to APIs & Services > Credentials
Click Create Credentials > OAuth client ID
Select Web application
Add redirect URI: https://<your-tenant>.runlayer.com/oauth/callback
Copy the Client ID and Client Secret

Add Server in Runlayer

In Runlayer, go to My connectors, select a Google service, and click Add connector
Check Custom OAuth credentials
Enter your Client ID and Client Secret
Click Deploy Server

Authorize

Click Connect on the server page
Sign in with Google and grant permissions

OAuth Scopes

Add these scopes when configuring OAuth consent:

Service	Scopes
Calendar	`https://www.googleapis.com/auth/calendar.events`, `https://www.googleapis.com/auth/calendar.calendars`, `https://www.googleapis.com/auth/calendar.calendarlist.readonly`, `https://www.googleapis.com/auth/calendar.freebusy`
Gmail	`https://www.googleapis.com/auth/gmail.readonly`, `https://www.googleapis.com/auth/gmail.send`, `https://www.googleapis.com/auth/gmail.modify`
Drive	`https://www.googleapis.com/auth/drive`
Docs	`https://www.googleapis.com/auth/drive`, `https://www.googleapis.com/auth/documents`
Sheets	`https://www.googleapis.com/auth/drive.metadata.readonly`, `https://www.googleapis.com/auth/spreadsheets`
Slides	`https://www.googleapis.com/auth/drive`, `https://www.googleapis.com/auth/presentations`
Forms	`https://www.googleapis.com/auth/drive.metadata.readonly`, `https://www.googleapis.com/auth/forms.body`, `https://www.googleapis.com/auth/forms.responses.readonly`

All connectors additionally request openid and https://www.googleapis.com/auth/userinfo.email for user identity.

Changing scopes on an existing connector

When a connector’s scopes change (for example, Google Forms moving from read-only access to read and write, so it can create and edit forms), an already-deployed connector needs these steps in this order:

Add the new scope to your OAuth consent screen (External apps only)

If your app’s user type is External, add the new scope(s) in APIs & Services > OAuth consent screen so users can consent to them. Internal (Google Workspace) apps can request any scope without listing it here, so you can skip this step. You can remove any scope the new one supersedes (e.g. forms.body covers forms.body.readonly).

Redeploy the connector

Redeploy the server so it picks up the new image and requests the new scope set. Until you redeploy, nothing changes for your users. By default the connector requests its built-in scopes, so a redeploy is enough — unless you’ve overridden them (see the note below).

Users re-authorize

Each user re-authorizes through their own MCP client, the same way they first connected (signing in with Google and granting access). Existing authorizations keep their previously granted scopes until the user re-authorizes, so users pick up the new capability individually as they reconnect — it isn’t something an admin does on each user’s behalf.

The connector requests its built-in scopes by default, so most deployments only need the redeploy. The exception is if you set a GOOGLE_OAUTH_SCOPES environment variable on the connector, which overrides the built-in scopes. To check, open your connector in Runlayer and look at its environment variables: if GOOGLE_OAUTH_SCOPES is set, add the new scope to it (otherwise a redeploy won’t change what’s requested); if it isn’t set, there’s nothing to do.

Each user will need to re-authorize before they can use the new tools. Until they do, tools that need the added scope return permission errors for that user, while their existing capabilities keep working.

Adding a sensitive or restricted scope to a published/verified External app may require re-verification by Google (verification of a related scope does not carry over). Internal (Google Workspace) apps do not need re-verification.

Troubleshooting

Redirect URI mismatch

Verify the redirect URL in Google Cloud Console matches exactly: https://<your-tenant>.runlayer.com/oauth/callback (no trailing slash).

Access blocked during OAuth

Ensure OAuth consent screen is configured. Add yourself as a test user if using External mode.

API not enabled

Enable the specific API in Google Cloud Console > APIs & Services > Library.

Invalid grant

Tokens may have expired. Disconnect and reconnect the server in Runlayer.

Insufficient permissions

Re-authorize with updated scopes. Ensure the API is enabled in your project.

Enable

Control

Self-Hosted Deployment

Operations

Cookbook

Integrations

Connectors

Resources

Available Tools

Google Calendar

Gmail

Google Drive

Google Docs

Google Sheets

Google Slides

Google Forms

Setup

OAuth Scopes

Changing scopes on an existing connector

Troubleshooting

​Available Tools

​Google Calendar

​Gmail

​Google Drive

​Google Docs

​Google Sheets

​Google Slides

​Google Forms

​Setup

​OAuth Scopes

​Changing scopes on an existing connector

​Troubleshooting

Available Tools

Google Calendar

Gmail

Google Drive

Google Docs

Google Sheets

Google Slides

Google Forms

Setup

OAuth Scopes

Changing scopes on an existing connector

Troubleshooting