Gmail MCP Server

Что умеет сервер

Сервер Gmail MCP предоставляется самим Google в составе удалённых MCP-серверов Google Workspace. Он отдаёт агенту десять инструментов: поиск цепочек писем, получение письма и цепочки целиком, создание черновика, список черновиков, список ярлыков, а также назначение и снятие ярлыков с писем и цепочек. Отправки писем среди этих инструментов нет: агент готовит черновик, а отправляете его вы.

Запрошенные при настройке права доступа соответствуют этому набору: чтение почты и составление писем (gmail.readonly и gmail.compose).

Когда использовать

Подключайте сервер, когда ассистент должен найти нужную переписку, пересказать цепочку, подготовить ответ в виде черновика или разложить письма по ярлыкам. Google отмечает общую идею Workspace MCP: агент читает данные, совершает действия и наследует те же права и правила защиты данных, что и сам пользователь.

Ограничения и безопасность

Сервер доступен только в рамках Google Workspace Developer Preview Program: нужно участие в программе, проект Google Cloud, включённые API Gmail и Gmail MCP и настроенный экран согласия OAuth. Для каждого клиента создаётся OAuth-клиент, а для Claude в адресах перенаправления указывается адрес обратного вызова Claude. Это предварительная версия, поэтому набор инструментов и условия могут измениться.

Чтобы пользователю не приходилось входить заново примерно каждый час, клиент должен получать токен обновления: для этого в запрос авторизации добавляют access_type=offline. Следите за тем, какие ярлыки меняет агент: правки ярлыков касаются реальной почты.

Адрес сервера

https://gmailmcp.googleapis.com/mcp/v1

Транспорт: Streamable HTTP, аутентификация: OAuth 2.0.

Подготовка проекта Google Cloud

Руководство Google включает API и MCP-службы всех продуктов Workspace сразу, с вашим идентификатором проекта вместо PROJECT_ID. Для Gmail нужны gmail.googleapis.com и gmailmcp.googleapis.com.

gcloud services enable gmail.googleapis.com drive.googleapis.com docs.googleapis.com sheets.googleapis.com slides.googleapis.com calendar-json.googleapis.com chat.googleapis.com people.googleapis.com classroom.googleapis.com --project = PROJECT_ID

gcloud services enable gmailmcp.googleapis.com drivemcp.googleapis.com docsmcp.googleapis.com sheetsmcp.googleapis.com slidesmcp.googleapis.com calendarmcp.googleapis.com chatmcp.googleapis.com people.googleapis.com classroommcp.googleapis.com --project = PROJECT_ID

Затем настройте экран согласия OAuth (Google Auth Platform, Branding, Audience, Data Access) и добавьте области доступа Gmail:

https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.compose

Claude (Claude.ai и Claude Desktop)

Нужен тариф Claude Enterprise, Pro, Max или Team. Создайте OAuth-клиент типа Web application, включите «Use this client for an AI-powered agent» и добавьте адрес перенаправления:

https://claude.ai/api/mcp/auth_callback

Затем в Settings, Connectors выберите Add custom connector, укажите адрес сервера Gmail и в Advanced settings введите идентификатор и секрет OAuth-клиента.

Antigravity

Добавьте в ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

Подключение по этому конфигу выполняется в настройках Antigravity (Customizations, Installed MCP Servers) или командой /mcp в Antigravity CLI.