GSuite MCP
mcp-gsuite
MCP-сервер для Gmail и Google Календаря на Python: поиск и чтение писем, черновики и ответы, события с участниками, несколько аккаунтов сразу
- 491 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Читает письма и вложения и сохраняет файлы на диск по пути, который называет агент
- Запрашивает полный доступ к почте `https://mail.google.com/`, создает ответы и по `send: true` отправляет их сразу
- Создает и удаляет события календаря и рассылает приглашения участникам
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-gsuiteОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает письма и вложения и сохраняет файлы на диск по пути, который называет агент
- Запрашивает полный доступ к почте `https://mail.google.com/`, создает ответы и по `send: true` отправляет их сразу
- Создает и удаляет события календаря и рассылает приглашения участникам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер запускается по stdio и дает агенту 12 инструментов для Gmail и Google Календаря от имени вашего аккаунта. В Gmail агент ищет письма по запросу Gmail (непрочитанные, от отправителя, по датам, с вложениями), читает письмо или сразу несколько по идентификаторам, создает и удаляет черновики, отвечает на письмо и сохраняет вложения в указанный каталог. Ответ по умолчанию сохраняется черновиком, а если агент передаст `send: true`, письмо уходит сразу. В Календаре агент смотрит список календарей и события за период, создает событие с названием, временем, местом, описанием, участниками, часовым поясом и выбором, рассылать ли приглашения, и удаляет события. Аккаунты описываются в файле `.accounts.json` с адресом, типом и полем `extra_info`, куда можно вписать подсказку агенту, например «здесь семейный календарь». Доступ к Google задается файлом клиента `.gauth.json`. При первом обращении к аккаунту открывается браузер, вы входите и подтверждаете права, а сервер сохраняет токен в локальный файл и дальше обновляет его сам.
Для кого. Для тех, кто разбирает почту и планирует встречи в Google и хочет поручить агенту в Claude Desktop черновики ответов, сводки по письмам и поиск свободных окон.
Подходит, если
- Нужна сводка непрочитанных писем или всех писем от бухгалтерии за период, с выжимкой по каждому
- Надо подготовить ответ на письмо и положить его в черновики, чтобы проверить перед отправкой
- Нужно подобрать время встречи на два часа на следующей неделе и сразу создать событие с приглашением
- Вложения из нескольких писем нужно собрать в один каталог на компьютере
- У вас рабочий и личный аккаунты, и агент должен смотреть оба календаря, понимая, что в каком лежит
Не подходит, если
- Работаете с другими сервисами Google: Документы, Таблицы и Диск сервер не затрагивает, для них есть google-docs-mcp
- Почта и календарь у вас в Яндексе, а не в Google: сервер работает только с Gmail и Google Календарем
- Не можете создать проект в Google Cloud и включить Gmail API: без собственного OAuth-клиента сервер не заработает
- Установлен Python старше 3.13: пакет требует версию 3.13 или новее
- Нельзя давать агенту полный доступ к почтовому ящику: сервер запрашивает права `https://mail.google.com/` без урезанных вариантов
Пример запроса к агенту
Найди непрочитанные письма от бухгалтерии за эту неделю, коротко перескажи каждое и подготовь черновик ответа на последнееMCP
- Транспорт
- stdio
- Авторизация
- OAuth
Ограничения
Проект версии 0.4.1, последнее изменение в репозитории от 14 апреля 2025 года. Лицензия MIT.
Нужен проект в Google Cloud с включенными Gmail API и Calendar API, экран согласия OAuth и клиент OAuth. Адрес обратного вызова должен быть `http://localhost:4100/code`. Запрашиваются права `openid`, `userinfo.email`, `https://mail.google.com/` (полный доступ к почте) и `calendar`.
Файлы `.gauth.json`, `.accounts.json` и токены лежат в рабочем каталоге в открытом виде. В документации токен назван `.oauth.{email}.json`, а в коде файл называется `.oauth2.` с идентификатором аккаунта. Пути задают флаги `--gauth-file`, `--accounts-file` и `--credentials-dir`.
Удаления писем нет, но есть удаление черновиков и событий календаря без корзины в самом инструменте.
Тексты писем и вложений попадают в диалог с моделью. Сохранение вложений пишет файлы по пути, который называет агент.
Как отключить. Уберите блок `mcp-gsuite` из `claude_desktop_config.json` и перезапустите Claude Desktop. Затем удалите файлы `.oauth` с токенами и отзовите доступ приложения на странице безопасности аккаунта Google.
Частые вопросы
Как получить доступ к Google для сервера?
В Google Cloud Console создайте проект, включите Gmail API и Calendar API, настройте экран согласия и создайте клиент OAuth типа «Desktop app» или «Web application». В список разрешенных адресов обратного вызова добавьте `http://localhost:4100/code`, а данные клиента сохраните в `.gauth.json`.
Что записать в .accounts.json?
Список `accounts` с полями `email`, `account_type` и `extra_info`. В `extra_info` пишут подсказку для агента, например какой календарь семейный. Аккаунтов может быть несколько, но все они должны иметь доступ в вашем OAuth-приложении.
Что происходит при первом обращении к аккаунту?
Открывается браузер, вы входите в Google и подтверждаете права. После этого сервер сохраняет данные входа в локальный файл и дальше обновляет токен автоматически.
Отправляет ли сервер письма сам?
Только если агент вызовет `reply_gmail_email` с `send: true`. По умолчанию ответ сохраняется черновиком. Новые письма сервер не отправляет, он создает только черновики.
Как установить через Smithery?
Команда `npx -y @smithery/cli install mcp-gsuite --client claude` ставит сервер в Claude Desktop. Настройку OAuth и файлы `.gauth.json` и `.accounts.json` все равно нужно сделать вручную.
Как отладить сервер?
Запустите MCP Inspector командой `npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite`. Журнал Claude Desktop можно смотреть командой `tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОдин MCP-сервер для Gmail, Календаря, Диска, Docs, Sheets, Slides, Forms, Tasks, Контактов, Chat и Apps Script с OAuth 2.1
Google Docs MCP — Docs, Sheets, Drive, Gmail и Calendar
Google Docs MCP
MCP-сервер дает агенту Google Docs, Sheets, Drive, Gmail, Calendar и Apps Script: чтение, правка, письма и события; вход через OAuth
Google Calendar MCP Server — календарь для Claude
Google Calendar MCP Server
MCP календарь для Claude Desktop: агент смотрит, создает, переносит и удаляет события Google Calendar, включая повторяющиеся, по запросу на обычном языке
MCP-сервер Яндекс Календаря
Яндекс Календарь MCP для Claude
MCP-сервер для Яндекс Календаря: просмотр, создание и удаление событий через пароль приложения
MCP-сервер Яндекс Календаря по CalDAV
yandex-calendar-mcp
MCP-сервер Яндекс Календаря по CalDAV: чтение расписания, создание и правка событий, приглашения с реальной отправкой писем
MCP сервер для календаря macOS: агент создает, находит и меняет события естественным языком
Коротко о README
В репозитории перечислены возможности для Gmail и Календаря, примеры просьб к агенту и порядок настройки: проект в Google Cloud, нужные права OAuth, файлы `.gauth.json` и `.accounts.json`. Приведены конфигурации Claude Desktop для запуска из исходников и из опубликованного пакета, описаны флаги путей, сборка и публикация пакета, отладка через MCP Inspector. Рядом лежат спецификации Gmail API и Calendar API в формате OpenAPI, а в `src/mcp_gsuite` — модули авторизации, Gmail и Календаря.