GWS-MCP

A local MCP (Model Context Protocol) server that connects Claude Desktop to Google Workspace using the Google Workspace CLI (`gws`).

This lets Claude read and manage your Gmail, Google Drive, Calendar, Docs, Sheets, Slides, and Google Classroom — all running locally on your machine.

---

The built-in Google connectors in Claude.ai require your Google Workspace admin to whitelist Claude. This setup bypasses that entirely — gws authenticates locally on your machine and Claude talks to it via MCP.

---

| Service | Tools | |---|---| | Gmail | Triage inbox, list/read emails, send, reply, forward | | Google Drive | List files, get file details, upload | | Google Calendar | View agenda, list events, create events | | Google Docs | Read, create, write/append | | Google Sheets | Read, write, append, create | | Google Slides | Get, create presentations | | Workflow | Standup report (today's meetings + unread emails) | | Google Classroom | List courses, assignments, announcements, submissions |

---

• Node.js 18+ — nodejs.org
• Google Workspace CLI — install via npm:

  npm install -g @googleworkspace/cli

• A Google Cloud project with OAuth credentials — console.cloud.google.com
• Claude Desktop — claude.ai/download

---

1. Go to console.cloud.google.com and create a project
2. Go to APIs & Services → OAuth consent screen

• Type: External
• Add your Google account under Test users

1. Go to APIs & Services → Credentials

• Click + Create Credentials → OAuth client ID
• Type: Desktop app
• Download the JSON and save it to ~/.config/gws/client_secret.json

Enable these APIs in your Google Cloud project:

• [Gmail API](http