Gmail MCP: почта, черновики и фильтры Gmail для агента

shinzo-labs/gmail-mcp· Проверено 12.11.2026· 65на GitHub

Даёт агенту ваш ящик Gmail через Gmail API: найти и прочитать письма и цепочки, написать черновик или отправить, разложить по ярлыкам, настроить фильтры и автоответ.

2 реализации:

65 инструментов почти на весь Gmail API: письма, цепочки, ярлыки, черновики, фильтры, пересылка, автоответ, псевдонимы и S/MIME.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Проект в Google Cloud Console с включённым Gmail API и OAuth Client ID типа Desktop app

Скачать JSON с ключами OAuth и сохранить как ~/.gmail-mcp/gcp-oauth.keys.json

Выполнить npx @shinzolabs/gmail-mcp auth и разрешить доступ в браузере: токен сохранится в ~/.gmail-mcp/credentials.json

gcp-oauth.keys.json

Google Cloud Console → Credentials → OAuth 2.0 Client ID типа Desktop app → скачать JSON

REFRESH_TOKEN

Нужен только для удалённой установки через Smithery вместе с CLIENT_ID и CLIENT_SECRET: лежит в ~/.gmail-mcp/credentials.json после команды auth

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio gmail \
  -- npx @shinzolabs/gmail-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.gmail]
command = "npx"
args = ["@shinzolabs/gmail-mcp"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["@shinzolabs/gmail-mcp"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "gmail": {
      "type": "stdio",
      "command": "npx",
      "args": ["@shinzolabs/gmail-mcp"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["@shinzolabs/gmail-mcp"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["@shinzolabs/gmail-mcp"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "gmail": {
        "type": "local",
        "command": ["npx", "@shinzolabs/gmail-mcp"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["@shinzolabs/gmail-mcp"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["@shinzolabs/gmail-mcp"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_messagesищет письма по фильтру

get_messageчитает письмо

get_attachmentскачивает вложение

send_messageотправляет письмо

modify_messageменяет ярлыки письма

trash_messageкладёт письмо в корзину

delete_messageудаляет письмо навсегда

batch_modify_messagesправит много писем разом

list_threadsперечисляет цепочки

get_threadчитает цепочку

list_labelsперечисляет ярлыки

create_labelсоздаёт ярлык

create_draftсоздаёт черновик

send_draftотправляет черновик

list_filtersперечисляет фильтры

create_filterсоздаёт фильтр

update_vacationнастраивает автоответ

update_auto_forwardingнастраивает пересылку

list_send_asперечисляет псевдонимы отправителя

get_profileчитает профиль ящика

Показано 20 из 65.

Шесть инструментов на Python: непрочитанные письма, чтение, ответ, корзина и открытие письма в браузере.

Как подключить

Что сделать до подключения

Менеджер пакетов uv и клон репозитория

Проект Google Cloud с Gmail API, экран согласия OAuth типа External с вашим адресом в Test users и scope https://www.googleapis.com/auth/gmail/modify

OAuth Client ID типа Desktop App: скачать JSON с ключами и указать путь к нему в --creds-file-path

--creds-file-path

JSON с ключами OAuth Client ID (Desktop App) из Google Cloud Console; при первом запуске вход откроется в браузере, токены сохранятся по пути из --token-path

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio gmail-mcp-server \
  -- uv --directory '<путь к клону gmail-mcp-server>' run gmail --creds-file-path '<путь к файлу ключей OAuth>' --token-path '<путь к файлу токенов>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.gmail-mcp-server]
command = "uv"
args = ["--directory", "<путь к клону gmail-mcp-server>", "run", "gmail", "--creds-file-path", "<путь к файлу ключей OAuth>", "--token-path", "<путь к файлу токенов>"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к клону gmail-mcp-server>",
        "run",
        "gmail",
        "--creds-file-path",
        "<путь к файлу ключей OAuth>",
        "--token-path",
        "<путь к файлу токенов>"
      ]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "gmail-mcp-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "<путь к клону gmail-mcp-server>",
        "run",
        "gmail",
        "--creds-file-path",
        "<путь к файлу ключей OAuth>",
        "--token-path",
        "<путь к файлу токенов>"
      ]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к клону gmail-mcp-server>",
        "run",
        "gmail",
        "--creds-file-path",
        "<путь к файлу ключей OAuth>",
        "--token-path",
        "<путь к файлу токенов>"
      ]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к клону gmail-mcp-server>",
        "run",
        "gmail",
        "--creds-file-path",
        "<путь к файлу ключей OAuth>",
        "--token-path",
        "<путь к файлу токенов>"
      ]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "gmail-mcp-server": {
        "type": "local",
        "command": [
          "uv",
          "--directory",
          "<путь к клону gmail-mcp-server>",
          "run",
          "gmail",
          "--creds-file-path",
          "<путь к файлу ключей OAuth>",
          "--token-path",
          "<путь к файлу токенов>"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к клону gmail-mcp-server>",
        "run",
        "gmail",
        "--creds-file-path",
        "<путь к файлу ключей OAuth>",
        "--token-path",
        "<путь к файлу токенов>"
      ]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к клону gmail-mcp-server>",
        "run",
        "gmail",
        "--creds-file-path",
        "<путь к файлу ключей OAuth>",
        "--token-path",
        "<путь к файлу токенов>"
      ]
    }
  }
}

Инструменты сервера

get-unread-emailsполучает непрочитанные

read-emailчитает письмо

send-emailотправляет письмо

mark-email-as-readотмечает прочитанным

trash-emailкладёт в корзину

open-emailоткрывает письмо в браузере

Что попросить агента

«Покажи непрочитанные письма и перескажи главное»Агент вызовет get-unread-emails и read-email

«Найди письма от <адрес> за последнюю неделю и повесь на них ярлык <ярлык>»Агент вызовет list_messages, затем batch_modify_messages

«Подготовь ответ на последнее письмо в цепочке <тема>, но не отправляй»Агент вызовет list_threads, get_thread и create_draft

«Включи автоответ: я в отпуске до <дата>»Агент вызовет update_vacation

«Создай фильтр, который отправляет рассылки от <адрес> в архив»Агент вызовет create_filter

Для каких задач

Разобрать непрочитанные и коротко пересказать важное

Найти письма по фильтру и разложить их по ярлыкам

Написать черновик ответа и отправить его после проверки

Создать фильтр для входящих и настроить автоответ на отпуск

Скачать вложение из письма

Ограничения

Оба сервера давно не обновлялись: Gmail MCP Server — с ноября 2025, 65 звёзд, Gmail Server for MCP — с февраля 2025, 73 звезды

Для подключения нужен свой проект в Google Cloud с OAuth Client ID: без него сервер не получит доступ к ящику

delete_message и batch_delete_messages удаляют письма навсегда, мимо корзины

Gmail MCP Server по умолчанию шлёт анонимную телеметрию; отключается переменной TELEMETRY_ENABLED=false

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Gmail MCP Server	Shinzo Labs	65	локально	вход	65	25 ноября 2025
Gmail Server for MCP	jasonsum	73	локально	вход	6	1 февраля 2025

Частые вопросы

Агент отправит письмо без моего ведома?

У Gmail Server for MCP клиент спрашивает подтверждение перед чтением, удалением и отправкой. Чтобы проверить текст до отправки в Gmail MCP Server, просите агента создать черновик через create_draft и отправить его потом через send_draft.

Где хранятся ключи и токены?

Gmail MCP Server держит ключи OAuth в ~/.gmail-mcp/gcp-oauth.keys.json, а токен пользователя в ~/.gmail-mcp/credentials.json; папка меняется переменной MCP_CONFIG_DIR. Gmail Server for MCP сохраняет токены по пути из --token-path.

Можно ли настроить один проект Google Cloud на всю компанию?

Да, в Gmail MCP Server клиент OAuth создаётся один раз на организацию, а каждый сотрудник копирует себе gcp-oauth.keys.json и сам запускает npx @shinzolabs/gmail-mcp auth.

Есть ли у Google свой Gmail MCP?

В списке MCP-серверов Google в репозитории google/mcp Gmail входит в открытый сервер Google Workspace: это расширение для Gemini CLI вместе с Docs, Sheets, Slides и Calendar. Отдельного Gmail-сервера в этом списке нет.

Как подключить Gmail MCP через Smithery?

Для Gmail MCP Server выполните npx -y @smithery/cli install @shinzo-labs/gmail-mcp и введите CLIENT_ID, CLIENT_SECRET и REFRESH_TOKEN. Первые два есть в файле ключей OAuth, третий появится в ~/.gmail-mcp/credentials.json после команды auth.

Работает ли сервер из России?

Серверы работают на вашем компьютере и обращаются к Gmail API, нужен аккаунт Google и проект в Google Cloud Console.

Gmail MCP: почта, черновики и фильтры Gmail для агента

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Какую реализацию выбрать

Частые вопросы

Похожие серверы