Google

Provides secure Google Workspace integration with intelligent contact resolution and safe, scoped OAuth2 access for Drive, Gmail, Calendar, and Contacts.

python

3

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "robcerda-google-mcp-server": {
      "command": "/path/to/google-mcp-server/.venv/bin/mcp",
      "args": [
        "run",
        "/path/to/google-mcp-server/server.py"
      ]
    }
  }
}

Transform Claude into a Google productivity assistant with secure, intent-aware actions for Gmail, Drive, and Calendar. The server handles smart contact resolution, safe file sharing, and attendee-aware calendar events, while keeping your data secure with restricted OAuth scopes and explicit two-step safety confirmations.

How to use

You interact with the Google MCP Server by connecting it to Claude via a local MCP client. The server resolves names to Google contacts, can share files by name with explicit previews, and can create calendar events with attendee resolution. All potentially risky actions require your explicit confirmation before execution.

How to install

Prerequisites: you need Python and a compatible MCP runner to manage the server locally.

Install the server code by cloning the project and installing dependencies.

git clone https://github.com/robcerda/google-mcp-server
cd google-mcp-server
uv sync

Prepare Google API credentials. Create a Google Cloud project, enable Drive, Gmail, Calendar, and People APIs, then create OAuth2 credentials of type Desktop app. Copy the generated client ID and client secret into your environment configuration.

cp .env.example .env
# Edit .env with your GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET

Add the server to your Claude Desktop configuration. Place the following MCP entry in claude_desktop_config.json so Claude can start the Google MCP Server.

{
  "mcpServers": {
    "google-services": {
      "command": "/path/to/google-mcp-server/.venv/bin/mcp",
      "args": ["run", "/path/to/google-mcp-server/server.py"]
    }
  }
}

Configuration and security

Security for this server centers on intentionally restrictive OAuth scopes and a two-step confirmation flow for all dangerous actions.

Default scopes (least privilege): drive.file, gmail.send, gmail.readonly, gmail.labels, contacts.readonly, calendar.

If you need broader access, you can add scopes in your environment configuration.

Example of adding broader scopes in your environment file.

env GOOGLE_ADDITIONAL_SCOPES=https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/gmail.modify

Examples

Smart Email: Send an email by name, letting the system resolve the exact address.

Safe File Sharing: Preview a file and require your confirmation to complete the share.

Calendar with Attendees: Create a meeting and resolve multiple attendee names to their Google accounts.

Safety & usage notes

All potentially dangerous operations require two steps: Prepare to preview and resolve, then Confirm to execute. No emails, shares, or invites are sent without your explicit approval.

Troubleshooting

If you run into issues starting the server, verify your environment variables are loaded, confirm the OAuth credentials are valid, and ensure the necessary Google APIs are enabled in your project.

Notes

The server uses a local runtime via a Python virtual environment and is designed to work with Claude through MCP. Ensure the path to your server script and virtual environment matches your setup.