GSuite
About
Interact with Google products, including Gmail and Calendar.
Details
- License
- MIT
Explore
- Supports multiple Google accounts with one configuration.
- Search and retrieve Gmail messages with flexible criteria.
- Create, delete, and reply to email drafts.
- Save multiple email attachments to local system.
- Manage multiple Google Calendars.
- Create calendar events with attendees, location, and timezone.
- Delete calendar events.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
GSuiteCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via Smithery with npx -y @smithery/cli install mcp-gsuite --client claude, or run locally using uv after cloning the repository. Configure OAuth2 by creating a .gauth.json file and a .accounts.json file in your working directory. Then add the server to your Claude Desktop configuration (e.g., claude_desktop_config.json). Optionally pass custom paths for accounts file and credentials directory via --accounts-file and --credentials-dir flags.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gsuite": {
"mcp-gsuite": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"mcp-gsuite",
"--client",
"claude"
]
}
}
}
}McpServers
{
"mcp-gsuite": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"mcp-gsuite",
"--client",
"claude"
]
}
}MCP server to interact with Google products.
Right now, this MCP server supports Gmail and Calendar integration with the following capabilities:
- 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.
- 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
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
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.
To install mcp-gsuite for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install mcp-gsuite --client claude
Google Workspace (G Suite) APIs require OAuth2 authorization. Follow these steps to set up authentication:
[ "openid", "https://mail.google.com/", "https://www.googleapis.com/auth/calendar", "https://www.googleapis.com/auth/userinfo.email" ]
- Then create a.gauth.jsonin your working directory with client
{ "web": { "client_id": "$your_client_id", "client_secret": "$your_client_secret", "redirect_uris": ["http://localhost:4100/code"], "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://oauth2.googleapis.com/token" } }
- Create a.accounts.jsonfile with account information
{ "accounts": [ { "email": "[email protected]", "account_type": "personal", "extra_info": "Additional info that you want to tell Claude: E.g. 'Contains Family Calendar'" } ] }
You can specifiy multiple accounts. Make sure they have access in your Google Auth app. Theextra_infofield 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.
On MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows:%APPDATA%/Claude/claude_desktop_config.json
{ "mcpServers": { "mcp-gsuite": { "command": "uv", "args": [ "--directory", "<dir_to>/mcp-gsuite", "run", "mcp-gsuite" ] } } }
Note: You can also use theuv run mcp-gsuite --accounts-file /path/to/custom/.accounts.jsonto specify a different accounts file or--credentials-dir /path/to/custom/credentialsto specify a different credentials directory.
{ "mcpServers": { "mcp-gsuite": { "command": "uv", "args": [ "--directory", "<dir_to>/mcp-gsuite", "run", "mcp-gsuite", "--accounts-file", "/path/to/custom/.accounts.json", "--credentials-dir", "/path/to/custom/credentials" ] } } }
{ "mcpServers": { "mcp-gsuite": { "command": "uvx", "args": [ "mcp-gsuite", "--accounts-file", "/path/to/custom/.accounts.json", "--credentials-dir", "/path/to/custom/credentials" ] } } }
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.jsonfile containing OAuth2 client configuration. Default is./.gauth.json.
- --accounts-file: Specifies the path to the.accounts.jsonfile 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.
uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials
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.
To prepare the package for distribution:
This will create source and wheel distributions in thedist/directory.
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token:--tokenorUV_PUBLISH_TOKEN
- Or username/password:--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using theMCP Inspector.
You can launch the MCP Inspector vianpmwith this command:
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite
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:
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log
An MCP server for interacting with Gmail and Google Calendar, enabling context-aware email and event management.
Integrate Google services like Gmail, Calendar, Drive, and Tasks with MCP.
(MCP) server for Google Workspace. Drive, Gmail, Calendar, Sheets, Docs, Tasks and People via AI agents.
Interact with Google Workspace services like Gmail and Google Calendar.
Integrates Google Workspace services like Calendar, Drive, and Gmail with AI assistants.
Manage Gmail, Calendar, Drive, and Contacts through Google Workspace APIs using OAuth 2.0.
Interact with Google Workspace services like Gmail and Google Calendar.
An MCP server for interacting with Google Workspace services like Gmail and Calendar.
Hyper-fast, local Gmail and Google Calendar indexing for Claude Code, available as a Skill or MCP Server.
Interact with Google products, including Gmail and Calendar.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
