Go Google MCP
Model Context Protocol (MCP) server for Google Workspace. Secure CRUD for Drive, Gmail, Calendar, Sheets, Docs, Tasks and People via AI agents.
Installation
npx go-google-mcpAsk AI about Go Google MCP
Powered by Claude Β· Grounded in docs
I know everything about Go Google MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
go-google-mcp
Unified Model Context Protocol (MCP) server for Google Workspace.
go-google-mcp is a powerful, secure, and extensible Go-based tool that allows AI agents (like Claude Desktop, Cursor, or Gemini CLI) to interact directly with your Google services through a standardized interface.
π Features
Interact with Google Workspace using natural language through these integrated services:
- π Google Drive: Powerful search, read text content, create files/folders, update content, move, share, and trash.
- π§ Gmail: Search/list threads, read full conversations, create drafts, move to trash, and send emails.
- π Google Calendar: List upcoming events, create new meetings (with attendees), and delete events.
- π Google Sheets: Create spreadsheets, read ranges, append rows, and update specific cells.
- π Google Docs: Create new documents and read full document text.
- π₯ Google People: List contacts and create new connections.
- β Google Tasks: List task lists and tasks, create, update, and delete tasks (with optional status/due filtering).
π Installation
Ensure you have Go installed (version 1.24 or later recommended).
go install github.com/matheusbuniotto/go-google-mcp/cmd/go-google-mcp@latest
π Authentication
This tool supports both User OAuth 2.0 (best for personal/CLI use) and Service Accounts (best for server/automated use).
Option 1: User OAuth (Recommended)
- Create Credentials: Go to the Google Cloud Console, enable the necessary APIs (Drive, Gmail, etc.), and create a Desktop App OAuth client.
- Download JSON: Save the client secrets file as
client_secrets.json. - One-time Login:
This securely saves your token togo-google-mcp auth login --secrets path/to/client_secrets.json~/.go-google-mcp/.
Option 2: Service Account
- Download your Service Account JSON key.
- Run with the
-credsflag:go-google-mcp -creds path/to/service-account.json
π€ Usage with AI Agents
Claude Desktop / Cursor
Add the following to your claude_desktop_config.json (or your IDE's MCP settings):
{
"mcpServers": {
"google-workspace": {
"command": "go-google-mcp",
"args": []
}
}
}
Gemini CLI
gemini mcp add google-workspace $(which go-google-mcp)
π Development
git clone https://github.com/matheusbuniotto/go-google-mcp.git
cd go-google-mcp
go build ./cmd/go-google-mcp
π License
MIT License. See LICENSE for details.
