Google Workspace MCP Server

A production-quality Model Context Protocol (MCP) server providing comprehensive access to Google Workspace services. Built with FastMCP and the official Google API client libraries.

Services Supported

📧 Gmail - Send, read, reply, drafts, labels, threads
📅 Google Calendar - Events, scheduling, availability
📊 Google Sheets - Read, write, manage spreadsheets
📄 Google Docs - Create, read, update documents
📁 Google Drive - Upload, download, search, organize files

Features

Native MCP Protocol - Works with Claude Desktop, Claude Code, and any MCP client
Full OAuth Support - Secure authentication with Google
Type-Safe - Pydantic models for all operations
Async - Built on async/await for performance
Comprehensive - 41 tools across 5 Google services

What's Included

✅ 41 Production-Ready Tools

📧 Gmail (9 tools): Send, read, reply, search, drafts, labels, threads
📅 Calendar (6 tools): Create events, manage meetings, free/busy queries
📊 Sheets (8 tools): Create, read, write, batch operations, metadata
📄 Docs (8 tools): Create, edit, format, find/replace, batch updates
📁 Drive (10 tools): Upload, download, search, share, organize files

Quick Start

1. Install

cd google-workspace-mcp-server
poetry install

2. Set Up Google OAuth

See SETUP.md for detailed instructions on:

Creating a Google Cloud project
Enabling required APIs
Getting OAuth credentials

3. Configure

cp .env.example .env
# Edit .env with your Google credentials

4. Test

poetry run python test_server.py

Expected output:

✅ Successfully imported MCP server
✅ Found 41 registered tools
📧 Gmail: 9 tools
📧 Calendar: 6 tools
📧 Sheets: 8 tools
📧 Docs: 8 tools
📧 Drive: 10 tools

Configuration

Create a .env file:

# Google OAuth Credentials
GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_REDIRECT_URI=http://localhost:8080

# Optional: Pre-authorized credentials
GOOGLE_CREDENTIALS_PATH=./credentials.json

Usage

Start the Server

poetry run python -m google_workspace_mcp

Use with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "poetry",
      "args": ["run", "python", "-m", "google_workspace_mcp"],
      "cwd": "/path/to/google-workspace-mcp-server"
    }
  }
}

Use with Claude Code

The server will be automatically discovered when running in the same project.

Available Tools

Gmail

gmail_send - Send an email
gmail_get - Get email by ID
gmail_list - List emails with filters
gmail_search - Search emails
gmail_reply - Reply to an email
gmail_draft_create - Create a draft
gmail_draft_send - Send a draft
gmail_labels_list - List all labels
gmail_thread_get - Get email thread

Calendar

calendar_event_create - Create calendar event
calendar_event_get - Get event details
calendar_event_list - List upcoming events
calendar_event_update - Update an event
calendar_event_delete - Delete an event

Sheets

sheets_create - Create new spreadsheet
sheets_read - Read sheet data
sheets_write - Write to sheet
sheets_append - Append rows
sheets_update - Update cells
sheets_clear - Clear range

Docs

docs_create - Create new document
docs_get - Get document content
docs_append - Append content
docs_insert - Insert at position
docs_replace - Find and replace

Drive

drive_upload - Upload file
drive_download - Download file
drive_search - Search for files
drive_list - List files in folder
drive_move - Move file
drive_delete - Delete file

Documentation

SETUP.md - Complete setup guide with Google Cloud configuration
TOOLS.md - Comprehensive tool reference with examples
README.md - This file, quick start and overview

Development

Built with:

MCP Python SDK - Model Context Protocol
Google API Python Client - Google Workspace APIs
FastMCP - Simplified MCP server framework

Project Structure

google-workspace-mcp-server/
├── src/google_workspace_mcp/
│   ├── __init__.py          # Package initialization
│   ├── __main__.py          # Entry point
│   ├── auth.py              # OAuth authentication manager
│   ├── server.py            # FastMCP server setup
│   ├── gmail.py             # Gmail tools (9)
│   ├── calendar.py          # Calendar tools (6)
│   ├── sheets.py            # Sheets tools (8)
│   ├── docs.py              # Docs tools (8)
│   └── drive.py             # Drive tools (10)
├── test_server.py           # Structure verification test
├── pyproject.toml           # Poetry dependencies
├── .env.example             # Configuration template
├── README.md                # This file
├── SETUP.md                 # Setup guide
└── TOOLS.md                 # Tool reference

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

MCP Servers