Skip to main content

Google Services MCP Servers

The platform provides MCP server integrations for Google services. All Google integrations use the same OAuth setup through Google Cloud Console, so you can configure credentials once and use them across multiple Google services.

Available Google Integrations​

ServiceWhat It Enables
Google CalendarRead and manage calendar events
GmailRead, search, and manage emails
Google DriveWork with files, folders, documents, spreadsheets, and presentations

OAuth Setup (Shared Across Google Services)​

All Google MCP servers authenticate using OAuth through Google Cloud Console. You need to create OAuth credentials once, then enable the required Google APIs for each service you want to use.

Step 1: Create a Google Cloud Project​

  1. Go to Google Cloud Console and sign in.
  2. Click the project dropdown at the top of the page.
  3. Click New Project, give it a name, and click Create.

Step 2: Enable the Required APIs​

Navigate to APIs & Services > Library and enable the APIs for the services you want to use:

ServiceAPI to Enable
Google CalendarGoogle Calendar API
GmailGmail API
Google DriveGoogle Drive API

📝 Note: The Google Drive API covers Drive, Docs, Sheets, and Slides functionality. You only need to enable the Drive API to access all of these capabilities.

  1. Go to Google Auth Platform > Branding (or APIs & Services > OAuth consent screen).
  2. Choose Internal (for organization-only access) or External (for any Google account).
  3. Fill in the required fields: app name, support email, and developer contact email.
  4. Under Data Access or Scopes, add the scopes for the services you need (listed in each service section below).
  5. Save.

Step 4: Create OAuth Credentials​

  1. Go to Google Auth Platform > Clients (or APIs & Services > Credentials).
  2. Click Create Client (or Create Credentials > OAuth client ID).
  3. Select Web application as the application type.
  4. Enter a name (for example, "Devs AI MCP").
  5. Under Authorized redirect URIs, add the redirect URL provided by your Devs.ai platform administrator.
  6. Click Create.
  7. Copy the Client ID and Client Secret from the confirmation dialog. Store them securely.

Step 5: Configure in Devs.ai​

  1. Navigate to Organization > Connectors in Devs.ai.
  2. Find the Google service template you want to enable and click Enable.
  3. Select OAuth as the authentication type.
  4. Enter your Client ID and Client Secret from Step 4.
  5. Select the tools you want to make available.
  6. Click Save.

Repeat Step 5 for each Google service you want to enable. You can reuse the same Client ID and Client Secret across all Google services.

OAuth Configuration Reference​

FieldValue
Authorization URLhttps://accounts.google.com/o/oauth2/v2/auth
Token URLhttps://oauth2.googleapis.com/token
Scopes Parameter Namescope
Additional Parametersaccess_type=offline, prompt=consent

📝 Note: The access_type=offline parameter ensures Google returns a refresh token so the platform can maintain access without requiring the user to re-authorize. The prompt=consent parameter ensures the consent screen always appears and a refresh token is always issued.

Google Calendar​

Google Calendar integration allows agents to read and manage a user's calendar events.

Capabilities​

Agents connected to Google Calendar can:

  • List calendars and events
  • Create new events
  • Update and delete events
  • Search for events by date range or keyword

Required Scope​

ScopeDescription
https://www.googleapis.com/auth/calendarFull read and write access to the user's calendars and events

Gmail​

Gmail integration allows agents to read, search, and manage a user's email.

Capabilities​

Agents connected to Gmail can:

  • List and read emails
  • Search for emails by sender, subject, or content
  • List email threads
  • Read email attachments metadata

Required Scopes​

The required scopes depend on the specific Gmail tools you enable. Refer to the Gmail API scopes documentation for the full list. Common scopes include:

ScopeDescription
https://www.googleapis.com/auth/gmail.readonlyRead-only access to emails and settings
https://www.googleapis.com/auth/gmail.sendSend emails on behalf of the user
https://www.googleapis.com/auth/gmail.modifyRead, send, and modify emails (excluding permanent deletion)

Google Drive​

Google Drive integration allows agents to work with files and folders in Google Drive, including Google Docs, Sheets, and Slides. This is a unified integration — the agent can work across file types within a single connection.

Capabilities​

Agents connected to Google Drive can work with:

Files and Folders:

  • List and search files and folders
  • Read file metadata
  • Access file contents and download links
  • Create and organize files

Google Docs:

  • Create new documents
  • Update document content
  • Export documents to various formats (PDF, plain text, etc.)

Google Sheets:

  • Create new spreadsheets
  • Read cell values and ranges
  • Update cell values and ranges
  • Export spreadsheets to various formats

Google Slides:

  • Create new presentations
  • Read presentation structure and content
  • Add, update, replace, and delete slides
  • Read and update speaker notes
  • Export presentations and slide thumbnails

Required Scopes​

ScopeDescription
https://www.googleapis.com/auth/driveFull access to files and folders in Google Drive, including Docs, Sheets, and Slides
https://www.googleapis.com/auth/drive.readonlyRead-only access to files and folders

Additional Resources​

⌘J