Canados00/google-workspace-mcp

Local MCP server for Gmail, Google Calendar and Contacts — runs on your own OAuth credentials, keeps secrets in the OS credential manager

About google-workspace-mcp

Почта, календарь и контакты Google для Claude — на ваших собственных креденшелах, без посредников.

Локальный MCP-сервер: Claude читает и отправляет вашу почту, работает с календарём и ищет контакты. Запросы идут напрямую в Google — никакой промежуточной инфраструктуры, через которую проходила бы ваша переписка.

Никакого посредника. Сервер работает локально и обращается к Google API напрямую. Письма не проходят через чужую инфраструктуру, где могут кэшироваться или логироваться.

Секретов нет на диске. Refresh-токен и ключи приложения лежат в системном менеджере учётных данных, зашифрованные ключом вашей учётной записи. В конфигурационных файлах пусто, в репозитории тем более.

Права урезаны намеренно. Удаление писем невозможно на уровне токена, а не только на уровне кода: соответствующий скоуп не запрашивается вообще. Скомпрометированный токен не сможет почистить ваш ящик.

Четыре слоя. Каждый следующий ничего не знает о предыдущем: обёртки Google API не подозревают о существовании MCP, а MCP-слой не разбирает MIME.

Почему так. Предметные модули (gmail, calendar, contacts) содержат всю логику, которая ломается на практике — кодировки, MIME, часовые пояса — и покрыты тестами без единого сетевого вызова. server.py остаётся тонким: он переводит параметры инструмента в вызов и форматирует ответ. Благодаря этому 300 тестов гоняются за девять секунд и не зависят от доступности Google.

Показателен тем, что проходит через все слои и через две точки, где операция может прерваться до отправки.

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/Canados00--google-workspace-mcp.html)

Related MCP servers