MCP Gsuite

🚀 mcp-gsuite MCP Server

An MCP server for interacting with Google products.

🚀 Quick Start

This MCP server enables interaction with Google products, offering seamless integration with Gmail and Google Calendar.

✨ Features

General

• Support for multiple Google accounts.

Gmail

• Retrieve Gmail user information.
• Search for emails using flexible queries (e.g., unread, from specific senders, date range, with attachments).
• Retrieve full email content by ID.
• Create new draft emails with options for recipients, subject, body, and CC.
• Delete draft emails.
• Reply to existing emails, either sending immediately or saving as a draft.
• Retrieve multiple emails by their IDs at once.
• Save multiple attachments from emails to the local system.

Calendar

• Manage multiple calendars.
• Get calendar events within a specified time range.
• Create calendar events with start and end times, title, location, and description.
• Update existing events or create new ones if they are recurring.
• Retrieve all Google calendars of the current user.
• Retrieve a single event by ID.
• Delete events.

📦 Installation

The MCP server can be configured to specify custom paths for authentication and account information via command-line options:

• --gauth-file: Specify the path to the .gauth.json file containing OAuth2 client configuration. The default is ./.gauth.json.
• --accounts-file: Specify the path to the .accounts.json file containing Google account information. The default is ./.accounts.json.
• --credentials-dir: Specify the directory to store OAuth credentials after successful authentication. The default is the current working directory, with each account using a subdirectory .oauth.{email}.json.

These options are very useful in development and testing scenarios, especially when managing multiple environments or different configuration sets.

📚 Documentation

Build and Release

Prepare the package for distribution:

1. Synchronize dependencies and update the lock file:

uv sync

2. Build the package distribution:

uv build

This will create source and wheel distributions in the dist/ directory. 3. Publish to PyPI:

uv publish

Note: You need to set PyPI credentials via environment variables or command-line flags:

• Token: --token or UV_PUBLISH_TOKEN
• Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

Since the MCP server runs via standard input and output, debugging can be challenging. For the best debugging experience, we highly recommend using MCP Inspector.

You can start the MCP Inspector with the following command:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

After starting, the Inspector will display a URL that you can access in your browser to start debugging.

You can also view server logs with the following command:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log