# gmail

Подключает Gmail к ИИ-ассистенту: чтение, поиск, метки, черновики и отправка писем. Работает с личными аккаунтами и Google Workspace.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 81
- Автор: pulsemcp
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/pulsemcp/mcp-servers/tree/HEAD/experimental/gmail
- Обновлён: 2026-10-09
- HTML: https://affpapa.org/nevibecode/mcp/gmail

## Что делает

Сервер отдаёт агенту инструменты Gmail: список переписок с фильтром по меткам, полный текст письма вместе со сведениями о вложениях, поиск через синтаксис запросов Gmail. Письма можно помечать прочитанными, ставить звезду, архивировать, вешать метки, готовить черновики и отправлять ответы.

Два способа авторизации. Для личного `@gmail.com` нужен OAuth2: проект в Google Cloud Console с включённым Gmail API, опубликованный экран согласия и Desktop-креденшелы. Refresh token получают командой `npx gmail-workspace-mcp-server oauth-setup <client_id> <client_secret>`; если порт 3000 занят, его меняют через `PORT`. Для Workspace нужен service account с доменной делегацией и правами на нужные области доступа.

Доступ режут группами инструментов через `GMAIL_ENABLED_TOOLGROUPS`: `readonly`, `readwrite` и `readwrite_external` с отправкой. По умолчанию включены все три, поэтому отправка писем доступна агенту сразу. Нет опубликованного экрана согласия — refresh token придётся обновлять каждые 7 дней.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `GMAIL_OAUTH_CLIENT_ID`, `GMAIL_OAUTH_CLIENT_SECRET`, `GMAIL_OAUTH_REFRESH_TOKEN`, `GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL`, `GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY`, `GMAIL_IMPERSONATE_EMAIL`, `GMAIL_ENABLED_TOOLGROUPS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: Gmail

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env GMAIL_OAUTH_CLIENT_ID=<GMAIL_OAUTH_CLIENT_ID> --env GMAIL_OAUTH_CLIENT_SECRET=<GMAIL_OAUTH_CLIENT_SECRET> --env GMAIL_OAUTH_REFRESH_TOKEN=<GMAIL_OAUTH_REFRESH_TOKEN> --env GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL=<GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL> --env GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY=<GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY> --transport stdio gmail -- npx -y gmail-workspace-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add gmail --env GMAIL_OAUTH_CLIENT_ID=<GMAIL_OAUTH_CLIENT_ID> --env GMAIL_OAUTH_CLIENT_SECRET=<GMAIL_OAUTH_CLIENT_SECRET> --env GMAIL_OAUTH_REFRESH_TOKEN=<GMAIL_OAUTH_REFRESH_TOKEN> --env GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL=<GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL> --env GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY=<GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY> -- npx -y gmail-workspace-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gmail": {
            "command": "npx",
            "args": [
                "-y",
                "gmail-workspace-mcp-server"
            ],
            "env": {
                "GMAIL_OAUTH_CLIENT_ID": "<GMAIL_OAUTH_CLIENT_ID>",
                "GMAIL_OAUTH_CLIENT_SECRET": "<GMAIL_OAUTH_CLIENT_SECRET>",
                "GMAIL_OAUTH_REFRESH_TOKEN": "<GMAIL_OAUTH_REFRESH_TOKEN>",
                "GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
                "GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "gmail": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "gmail-workspace-mcp-server"
            ],
            "env": {
                "GMAIL_OAUTH_CLIENT_ID": "<GMAIL_OAUTH_CLIENT_ID>",
                "GMAIL_OAUTH_CLIENT_SECRET": "<GMAIL_OAUTH_CLIENT_SECRET>",
                "GMAIL_OAUTH_REFRESH_TOKEN": "<GMAIL_OAUTH_REFRESH_TOKEN>",
                "GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
                "GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e GMAIL_OAUTH_CLIENT_ID=<GMAIL_OAUTH_CLIENT_ID> -e GMAIL_OAUTH_CLIENT_SECRET=<GMAIL_OAUTH_CLIENT_SECRET> -e GMAIL_OAUTH_REFRESH_TOKEN=<GMAIL_OAUTH_REFRESH_TOKEN> -e GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL=<GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL> -e GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY=<GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY> gmail npx -y gmail-workspace-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

## Когда брать
- найти письмо по запросу в синтаксисе Gmail
- разобрать переписку и вытащить из неё вложения
- собрать черновик ответа прямо из контекста задачи
- разложить входящие по меткам без ручного клика
- ограничить агенту доступ к почте только чтением

## Примеры запросов агенту
- Найди в Gmail переписку с подрядчиком за март и покажи последнее письмо
- Сделай черновик ответа на это письмо и сохрани в Gmail
- Отправь письмо на адрес из `contacts.md` с темой «Созвон в пятницу»

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md