home / mcp / gsuite mcp server
MCP Server to interact with Google Gsuite prodcuts
Configuration
View docs{
"mcpServers": {
"albert-launcher-mcp-gsuite": {
"command": "uvx",
"args": [
"mcp-gsuite"
]
}
}
}You can connect Claude to Google Workspace services to manage Gmail and Calendar data directly from your conversations. This MCP server lets you work with multiple Google accounts, read and send emails, manage drafts, and handle calendar events from within your AI prompts.
Use the MCP server to operate Gmail and Calendar from your chat. You can switch between multiple Google accounts, query emails with flexible criteria, retrieve full email content, create and manage drafts, and perform calendar operations like creating and deleting events. Specifically, you can ask Claude to fetch unread messages, search emails from certain people, summarize a specific message, or draft replies. For calendars, you can check your agenda for a time window, or plan events with suggested slots.
Prerequisites you need before install: - Node.js runtime available on your machine - Access to a terminal or command prompt - Basic familiarity with running command-line utilities Follow these steps to install and run the MCP server for G Suite integration.
1) Install the MCP server via Smithery (this pulls the MCP package into your environment):
```bash
npx -y @smithery/cli install @alBERT-launcher/mcp-gsuite --client claude
```
2) Run development server locally using the standard runtime (example shown for development use):
```json
{
"mcpServers": {
"mcp-gsuite": {
"command": "uv",
"args": [
"--directory",
"<dir_to>/mcp-gsuite",
"run",
"mcp-gsuite"
]
}
}
}
```
3) If you are using the published configuration, run the MCP server with the published command:
```json
{
"mcpServers": {
"mcp-gsuite": {
"command": "uvx",
"args": [
"mcp-gsuite"
]
}
}
}
```
4) Start the server in your environment using the appropriate configuration block for your setup. The server will handle authentication flows and manage credentials locally as you authorize Google access for the accounts you specify.The MCP server accepts a few command-line options to customize authentication and which accounts to use. You can point the server to specific files that contain your OAuth2 configuration and account details.
Configuration options you may set include:
- --gauth-file: Path to the OAuth2 client configuration file. Default is ./\.gauth.json
- --accounts-file: Path to the accounts file containing Google account information. Default is ./\.accounts.json
- --credentials-dir: Directory where OAuth credentials are stored after successful authentication. Default is a per-account subdirectory named .oauth.{email} in the current working directory
These options let you manage multiple environments or different credentials sets without mixing data.Google Workspace APIs require OAuth2 authorization. You will create OAuth credentials in a Google Cloud project, enable Gmail and Calendar APIs, and configure redirect URIs for local development. The first time you run the tools for a given account, a browser window will open to complete the login flow and grant scopes. Credentials are stored locally for future use, and refresh tokens are used automatically.
If you encounter access issues, verify that the Google account has permission to access Gmail and Calendar data for the requested scopes. Ensure the redirect URI http://localhost:4100/code is reachable during the OAuth flow. Check that you have multiple accounts configured correctly in the accounts file and that the local credentials directory is writable.
Gmail capabilities include querying emails with flexible search, retrieving content by ID, creating and sending drafts, deleting drafts, replying to messages, and saving attachments. Calendar capabilities include managing multiple calendars, retrieving events within a time window, creating events with title, time, location, attendees, and notifications, and deleting events.
The following functions are exposed to you via the MCP server to interact with Gmail and Calendar: - gmail_get_user - gmail_search - gmail_get_content - gmail_create_draft - gmail_delete_draft - gmail_reply - gmail_get_multiple - gmail_save_attachments - calendar_get_events - calendar_create_event - calendar_delete_event - calendar_manage_calendars These tools enable you to perform common email and calendar tasks directly from your prompts.
- 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 - Plan an event with Tim for 2hrs next week and get suggested time slots - Check what I have on my private Family calendar for tomorrow - Create a calendar event with title, times, location, attendees, and a reminder
During development, you can use the MCP Inspector for a better debugging experience. It launches a debugging interface in your browser and shows runtime details. You can also tail logs to monitor server activity.
{
"mcpServers": {
"mcp-gsuite": {
"command": "uvx",
"args": [
"mcp-gsuite"
]
}
}
}On macOS you will typically find client configuration files under your user library, and on Windows under your AppData folder. Use these locations as guidance when wiring up your own environment, and ensure your paths in the configuration point to existing files.
Primary language: JavaScript. You interact with the MCP server through command-line tools and JSON configuration. The tooling you’ll rely on includes NPC/UV-based runtime helpers and the MCP Inspector for debugging.
Fetch basic Gmail user information for a given account.
Query emails with flexible search filters such as unread status, sender, date ranges, and attachments.
Retrieve complete email content by ID.
Create a new draft email with recipients, subject, body, and optional CC.
Delete a draft email by ID.
Reply to an existing email, with option to send immediately or save as draft.
Retrieve multiple emails by their IDs in a single operation.
Save attachments from emails to your local system.
Get calendar events within a specified time range for one or more calendars.
Create a calendar event with title, start/end times, location, description, attendees, timezone, and notification preferences.
Delete a calendar event by ID.
Manage multiple calendars, including creation and configuration.