a-bonus/google-docs-mcp

What it solves

This project provides a Model Context Protocol (MCP) server that allows AI assistants (like Claude Desktop, Cursor, or Windsurf) to interact directly with the Google Workspace ecosystem. It eliminates the need for manual copy-pasting by giving LLMs the ability to read, create, and modify content across Google Docs, Sheets, Drive, Gmail, and Calendar.

How it works

The server acts as a bridge between an MCP-compatible client and the Google APIs. It uses OAuth 2.0 for authentication and exposes a wide array of "tools" that the AI can call. These tools map to specific API actions, such as reading a document as markdown, appending rows to a spreadsheet, or searching for emails. It can be deployed locally via npx or remotely on Google Cloud Run for team-wide access.

Who it’s for

Users of AI code editors and assistants who want their LLM to have direct access to their personal or professional Google Workspace data for automation, document drafting, and scheduling.

Highlights

• Comprehensive Workspace Integration: Full CRUD operations for Google Docs, Sheets, Drive, Gmail, and Calendar.
• Markdown Workflow: Supports reading and replacing document content using markdown for easier LLM editing.
• Detailed Sheet Control: Advanced spreadsheet tools including cell formatting, conditional formatting, table creation, and range protection.
• Gmail & Calendar Automation: Tools for inbox triage, sending emails, managing drafts, and scheduling events with Google Meet links.
• Apps Script Support: Ability to create and edit the underlying Apps Script projects for further automation.
• Flexible Deployment: Supports both local stdio transport and remote httpStream deployment via Cloud Run.