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.

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

License

MIT License - see LICENSE file for details

Acknowledgments

• Built with FastMCP
• Uses Google API Python Client
• Follows the Model Context Protocol specification

Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions