{"id":47782097,"url":"https://github.com/matheusbuniotto/go-google-mcp","last_synced_at":"2026-04-03T13:39:06.536Z","repository":{"id":335749014,"uuid":"1146910638","full_name":"matheusbuniotto/go-google-mcp","owner":"matheusbuniotto","description":"Model Context Protocol (MCP) server for Google Workspace. Secure CRUD for Drive, Gmail, Calendar, Sheets, Docs, Tasks and People via AI agents.","archived":false,"fork":false,"pushed_at":"2026-02-10T13:50:23.000Z","size":80,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-10T18:31:09.314Z","etag":null,"topics":["ai-agent","docs","drive","gmail","go","golang","google","google-api","google-workspace","integration","llm","mcp","spreadsheet"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matheusbuniotto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-31T22:00:04.000Z","updated_at":"2026-02-10T13:49:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/matheusbuniotto/go-google-mcp","commit_stats":null,"previous_names":["matheusbuniotto/go-google-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/matheusbuniotto/go-google-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusbuniotto%2Fgo-google-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusbuniotto%2Fgo-google-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusbuniotto%2Fgo-google-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusbuniotto%2Fgo-google-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matheusbuniotto","download_url":"https://codeload.github.com/matheusbuniotto/go-google-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusbuniotto%2Fgo-google-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31353780,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T08:03:20.796Z","status":"ssl_error","status_checked_at":"2026-04-03T08:00:37.834Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","docs","drive","gmail","go","golang","google","google-api","google-workspace","integration","llm","mcp","spreadsheet"],"created_at":"2026-04-03T13:39:05.845Z","updated_at":"2026-04-03T13:39:06.531Z","avatar_url":"https://github.com/matheusbuniotto.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# go-google-mcp\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/matheusbuniotto/go-google-mcp)](https://goreportcard.com/report/github.com/matheusbuniotto/go-google-mcp)\n[![CI](https://github.com/matheusbuniotto/go-google-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/matheusbuniotto/go-google-mcp/actions/workflows/ci.yml)\n\n**Unified Model Context Protocol (MCP) server for Google Workspace.**\n\n`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.\n\n## 🚀 Features\n\nInteract with Google Workspace using natural language through these integrated services:\n\n- **📂 Google Drive**: Powerful search, read text content, create files/folders, update content, move, share, and trash.\n- **📧 Gmail**: Search/list threads, read full conversations, create drafts, move to trash, and send emails.\n- **📅 Google Calendar**: List upcoming events, create new meetings (with attendees), and delete events.\n- **📊 Google Sheets**: Create spreadsheets, read ranges, append rows, and update specific cells.\n- **📄 Google Docs**: Create new documents and read full document text.\n- **👥 Google People**: List contacts and create new connections.\n- **✅ Google Tasks**: List task lists and tasks, create, update, and delete tasks (with optional status/due filtering).\n\n## 🛠 Installation\n\nEnsure you have [Go](https://go.dev/doc/install) installed (version 1.24 or later recommended).\n\n```bash\ngo install github.com/matheusbuniotto/go-google-mcp/cmd/go-google-mcp@latest\n```\n\n## 🔐 Authentication\n\nThis tool supports both **User OAuth 2.0** (best for personal/CLI use) and **Service Accounts** (best for server/automated use).\n\n### Option 1: User OAuth (Recommended)\n\n1.  **Create Credentials**: Go to the [Google Cloud Console](https://console.cloud.google.com/), enable the necessary APIs (Drive, Gmail, etc.), and create a **Desktop App** OAuth client.\n2.  **Download JSON**: Save the client secrets file as `client_secrets.json`.\n3.  **One-time Login**:\n    ```bash\n    go-google-mcp auth login --secrets path/to/client_secrets.json\n    ```\n    *This securely saves your token to `~/.go-google-mcp/`.*\n\n### Option 2: Service Account\n\n1.  Download your Service Account JSON key.\n2.  Run with the `-creds` flag:\n    ```bash\n    go-google-mcp -creds path/to/service-account.json\n    ```\n\n## 🤖 Usage with AI Agents\n\n### Claude Desktop / Cursor\n\nAdd the following to your `claude_desktop_config.json` (or your IDE's MCP settings):\n\n```json\n{\n  \"mcpServers\": {\n    \"google-workspace\": {\n      \"command\": \"go-google-mcp\",\n      \"args\": []\n    }\n  }\n}\n```\n\n### Gemini CLI\n\n```bash\ngemini mcp add google-workspace $(which go-google-mcp)\n```\n\n## 🛠 Development\n\n```bash\ngit clone https://github.com/matheusbuniotto/go-google-mcp.git\ncd go-google-mcp\ngo build ./cmd/go-google-mcp\n```\n\n## 📜 License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatheusbuniotto%2Fgo-google-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatheusbuniotto%2Fgo-google-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatheusbuniotto%2Fgo-google-mcp/lists"}