Skip to main content

Google Workspace MCP Server

A Model Context Protocol server that provides AI assistants with comprehensive, read-only access to Google Workspace APIs across four services: Gmail, Calendar, Drive, and Sheets.

What can it do?​

Ask your AI assistant questions like:

  • "Show me my unread emails from today."
  • "What meetings do I have this week?"
  • "Find the Q4 report in my Drive."
  • "Read rows A1:D50 from my budget spreadsheet."
  • "Search Gmail for invoices with PDF attachments."
  • "Who is attending tomorrow's standup?"
  • "List all sheets in spreadsheet abc123."
  • "What files did I modify last week?"

Features​

  • 12 read-only tools across 4 services (Gmail, Calendar, Drive, Sheets)
  • Multi-service architecture — a single MCP server covers all major Workspace APIs through a unified auth layer
  • LLM-optimized responses — Gmail bodies are decoded from base64url, Calendar events are simplified, Drive files are flattened, and Google metadata (kind, etag) is stripped
  • Type-safe — built with TypeScript and Zod schema validation
  • Security-first — read-only by design

Supported Resources​

ServiceTools
Gmaillist_messages, get_message, search_messages
Calendarlist_calendars, list_events, get_event
Drivelist_files, get_file, search_files
Sheetsget_spreadsheet, get_sheet_values, list_sheets

Prerequisites​

  • Node.js >= 20
  • A Google OAuth access token with appropriate scopes. For Phase 1, you can get one from the OAuth 2.0 Playground.
Phase 2 Roadmap

A future release will add service account authentication and an OAuth browser flow for automatic token refresh, removing the need to manually obtain tokens.