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.

How to use

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.

How to install

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):

{
  "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:

{
  "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.

## Configuration and runtime options

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.

## Security and authentication

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.

## Troubleshooting and tips

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.

## Examples of supported capabilities

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.

## Available tools and endpoints

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.

## Examples 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
- 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

## Development and debugging notes

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.

## Configuration snippets

{ "mcpServers": { "mcp-gsuite": { "command": "uvx", "args": [ "mcp-gsuite" ] } } }

## Notes on local development paths

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.

## Environment and language

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.

## Available tools

### gmail\_get\_user

Fetch basic Gmail user information for a given account.

### gmail\_search

Query emails with flexible search filters such as unread status, sender, date ranges, and attachments.

### gmail\_get\_content

Retrieve complete email content by ID.

### gmail\_create\_draft

Create a new draft email with recipients, subject, body, and optional CC.

### gmail\_delete\_draft

Delete a draft email by ID.

### gmail\_reply

Reply to an existing email, with option to send immediately or save as draft.

### gmail\_get\_multiple

Retrieve multiple emails by their IDs in a single operation.

### gmail\_save\_attachments

Save attachments from emails to your local system.

### calendar\_get\_events

Get calendar events within a specified time range for one or more calendars.

### calendar\_create\_event

Create a calendar event with title, start/end times, location, description, attendees, timezone, and notification preferences.

### calendar\_delete\_event

Delete a calendar event by ID.

### calendar\_manage\_calendars

Manage multiple calendars, including creation and configuration.