Allows querying and searching emails, retrieving email content, creating draft emails, deleting drafts, replying to emails, and saving attachments from emails to local system. Supports multiple Google accounts.
Provides integration with Google products, specifically Gmail and Google Calendar, supporting multiple Google accounts and OAuth2 authentication.
Enables managing multiple calendars, retrieving events within specified time ranges, creating calendar events with customizable options (title, time, location, attendees, timezone, notifications), and deleting calendar events.
Used as part of the authentication process for Google services, providing secure identity verification when connecting to Gmail and Google Calendar.
mcp-gsuite MCP server
MCP server to interact with Google produts.
Example prompts
Right now, this MCP server supports Gmail and Calendar integration with the following capabilities:
General
Multiple google accounts
Gmail
Get your Gmail user information
Query emails with flexible search (e.g., unread, from specific senders, date ranges, with attachments)
Retrieve complete email content by ID
Create new draft emails with recipients, subject, body and CC options
Delete draft emails
Reply to existing emails (can either send immediately or save as draft)
Retrieve multiple emails at once by their IDs.
Save multiple attachments from emails to your local system.
Calendar
Manage multiple calendars
Get calendar events within specified time ranges
Create calendar events with:
Title, start/end times
Optional location and description
Optional attendees
Custom timezone support
Notification preferences
Delete calendar events
Example prompts you can try:
Retrieve my latest unread messages
Search my emails from the Scrum Master
Retrieve all emails from accounting
Take the email about ABC and summarize it
Write a nice response to Alice's last email and upload a draft.
Reply to Bob's email with a Thank you note. Store it as draft
What do I have on my agenda tomorrow?
Check my private account's Family agenda for next week
I need to plan an event with Tim for 2hrs next week. Suggest some time slots.
Quickstart
Install
Installing via Smithery
To install G Suite Integration for Claude Desktop automatically via Smithery:
Oauth 2
Google Workspace (G Suite) APIs require OAuth2 authorization. Follow these steps to set up authentication:
Create OAuth2 Credentials:
Go to the Google Cloud Console
Create a new project or select an existing one
Enable the Gmail API and Google Calendar API for your project
Go to "Credentials" → "Create Credentials" → "OAuth client ID"
Select "Desktop app" or "Web application" as the application type
Configure the OAuth consent screen with required information
Add authorized redirect URIs (include
http://localhost:4100/code
for local development)
Required OAuth2 Scopes:
Then create a
.gauth.json
in your working directory with client
Create a
.accounts.json
file with account information
You can specifiy multiple accounts. Make sure they have access in your Google Auth app. The extra_info
field is especially interesting as you can add info here that you want to tell the AI about the account (e.g. whether it has a specific agenda)
Note: When you first execute one of the tools for a specific account, a browser will open, redirect you to Google and ask for your credentials, scope, etc. After a successful login, it stores the credentials in a local file called .oauth.{email}.json
. Once you are authorized, the refresh token will be used.
Claude Desktop
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Configuration Options
The MCP server can be configured with several command-line options to specify custom paths for authentication and account information:
--gauth-file
: Specifies the path to the.gauth.json
file containing OAuth2 client configuration. Default is./.gauth.json
.--accounts-file
: Specifies the path to the.accounts.json
file containing information about the Google accounts. Default is./.accounts.json
.--credentials-dir
: Specifies the directory where OAuth credentials are stored after successful authentication. Default is the current working directory with a subdirectory for each account as.oauth.{email}.json
.
These options allow for flexibility in managing different environments or multiple sets of credentials and accounts, especially useful in development and testing scenarios.
Example usage:
This configuration is particularly useful when you have multiple instances of the server running with different configurations or when deploying to environments where the default paths are not suitable.
Development
Building and Publishing
To prepare the package for distribution:
Sync dependencies and update lockfile:
Build package distributions:
This will create source and wheel distributions in the dist/
directory.
Publish to PyPI:
Note: You'll need to set PyPI credentials via environment variables or command flags:
Token:
--token
orUV_PUBLISH_TOKEN
Or username/password:
--username
/UV_PUBLISH_USERNAME
and--password
/UV_PUBLISH_PASSWORD
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via with this command:
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
You can also watch the server logs with this command:
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integration server that enables interaction with Google services including Gmail and Calendar, allowing users to manage emails, draft responses, and schedule events across multiple Google accounts.
Related MCP Servers
- AsecurityAlicenseAqualityProvides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.Last updated -26MIT License
- -securityAlicense-qualityServer for Google Calendar integration in Cluade Desktop with auto authentication support. This server enables AI assistants to manage Google Calendar events through natural language interactions.Last updated -912MIT License
- -securityFlicense-qualityAn integration server that provides Claude Desktop access to Gmail, enabling users to view recent emails and search their Gmail inbox using natural language commands.Last updated -7
- -securityAlicense-qualityAn integration server that allows Claude Desktop to securely access and process Gmail content while maintaining proper context management and privacy controls.