taylorwilsdon/google_workspace_mcp

Overview

A Python-based MCP server and CLI tool that lets AI agents control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, and Drive. It exposes Google Workspace APIs through the Model Context Protocol for integration with compatible AI assistants.

Best for

Best for
Developers building AI assistants that need direct control over Google Workspace services

Use cases

• Automate email drafting, sending, and inbox management via AI agents
• Create, update, and query Google Calendar events programmatically
• Read and write Google Docs, Sheets, and Slides through natural language commands

How to use

Install

uvx workspace-mcp --tool-tier core       # essential tools

Tools exposed

• GOOGLE_OAUTH_CLIENT_ID
• GOOGLE_OAUTH_CLIENT_SECRET
• OAUTHLIB_INSECURE_TRANSPORT
• USER_GOOGLE_EMAIL
• GOOGLE_CLIENT_SECRET_PATH
• GOOGLE_MCP_CREDENTIALS_DIR
• WORKSPACE_MCP_BASE_URI
• WORKSPACE_MCP_PORT
• WORKSPACE_MCP_HOST
• WORKSPACE_MCP_TRANSPORT
• WORKSPACE_MCP_HTTP_PORT
• WORKSPACE_EXTERNAL_URL
• WORKSPACE_MCP_BRAND_NAME
• WORKSPACE_MCP_BRAND_ICON_URL
• WORKSPACE_MCP_BRAND_WEBSITE_URL
• WORKSPACE_ATTACHMENT_DIR
• WORKSPACE_MCP_URL
• ALLOWED_FILE_DIRS
• WORKSPACE_MCP_TOOLS
• WORKSPACE_MCP_TOOL_TIER

Tested with

Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT

Notes

A Python-based MCP server and CLI tool that lets AI agents control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, and Drive. It exposes Google Workspace APIs through the Model Context Protocol for integration with compatible AI assistants.

2,528 stars on GitHub. Last updated 2026-05-30. Licensed MIT.

Use cases

• Automate email drafting, sending, and inbox management via AI agents
• Create, update, and query Google Calendar events programmatically
• Read and write Google Docs, Sheets, and Slides through natural language commands

Pros

• Covers nearly all major Google Workspace services in one tool
• Well-documented with 2,500+ GitHub stars indicating community trust
• Works as both a CLI tool and an MCP server for flexible integration

Cons

• Requires Google API credentials and OAuth setup, which can be complex
• Limited to Python runtime and MCP-compatible AI clients
• May hit Google API rate limits under heavy automated usage

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.