Provides comprehensive Gmail API access including sending/drafting emails, message and thread management, label operations, attachment handling, settings configuration (vacation responder, IMAP/POP), and mailbox history tracking.
Enables OAuth2 authentication using Google Cloud credentials for secure access to Gmail services.
Реализация протокола контекста модели (MCP) для API Gmail , предоставляющая стандартизированный интерфейс для управления электронной почтой, ее отправки и извлечения.
Чтобы запустить этот сервер MCP, вам сначала необходимо настроить клиент Google API для вашей организации, при этом каждый пользователь должен запустить скрипт для получения собственного токена обновления OAuth.
http://localhost:3000/oauth2callback в качестве URI авторизованного перенаправления».~/.gmail-mcp/gcp-oauth.keys.json .CLIENT_ID и CLIENT_SECRET из этого файла.~/.gmail-mcp/gcp-oauth.keys.json на свой компьютер по тому же пути.npx @shinzolabs/gmail-mcp auth .~/.gmail-mcp/credentials.json ). REFRESH_TOKEN пользователя будет найден здесь.Существует несколько вариантов настройки клиента MCP с сервером. Для настройки сервера на хосте/удалённом сервере используйте CLI Smithery с ключом API Smithery . Для локальной установки используйте npx или сборку из исходников. Каждый из этих вариантов поясняется ниже.
Чтобы добавить удаленный сервер в config.json вашего клиента MCP, выполните следующую команду из Smithery CLI :
При появлении соответствующего запроса введите CLIENT_ID , CLIENT_SECRET и REFRESH_TOKEN .
Если вы разрабатываете собственное приложение-агент, вы можете использовать шаблонный код здесь .
Чтобы установить сервер локально с помощью npx , добавьте следующее в config.json вашего клиента MCP:
pnpm (внутри клонированного репозитория):config.json вашего клиента MCP:| Переменная | Описание | Необходимый? | Значение по умолчанию |
|---|---|---|---|
AUTH_SERVER_PORT | Порт для сервера аутентификации OAuth | Нет | 3000 |
CLIENT_ID | Идентификатор клиента API Google (находится в GMAIL_OAUTH_PATH ) | Да, если подключение к удаленному серверу | '' |
CLIENT_SECRET | Секретный ключ клиента API Google (находится в GMAIL_OAUTH_PATH ) | Да, если подключение к удаленному серверу | '' |
GMAIL_CREDENTIALS_PATH | Путь к файлу учетных данных пользователя | Нет | MCP_CONFIG_DIR/credentials.json |
GMAIL_OAUTH_PATH | Путь к файлу клиента Google API | Нет | MCP_CONFIG_DIR/gcp-oauth.keys.json |
LOG_PATH | Путь к журналам | Нет | MCP_CONFIG_DIR/gmail-mcp.log |
MCP_CONFIG_DIR | Каталог для хранения файлов конфигурации | Нет | ~/.gmail-mcp |
REFRESH_TOKEN | Токен обновления OAuth (находится в GMAIL_CREDENTIALS_PATH ) | Да, если подключение к удаленному серверу | '' |
get_profile : Получить профиль Gmail текущего пользователяstop_mail_watch : Прекратить получать push-уведомленияwatch_mailbox : Настройка push-уведомлений об изменениях в почтовом ящикеlist_messages : Список сообщений с дополнительной фильтрациейget_message : Получить определенное сообщениеget_attachment : Получить вложение к сообщениюmodify_message : Изменить метки сообщенийsend_message : Отправить сообщение электронной почты указанным получателямdelete_message : Удалить сообщение навсегдаtrash_message : Переместить сообщение в корзинуuntrash_message : Удалить сообщение из корзиныbatch_modify_messages : Изменить несколько сообщенийbatch_delete_messages : Удалить несколько сообщенийlist_labels : Список всех метокget_label : Получить определенную меткуcreate_label : Создать новую меткуupdate_label : Обновить меткуpatch_label : Частичное обновление меткиdelete_label : Удалить меткуlist_threads : Список тем электронной почтыget_thread : Получить определенную веткуmodify_thread : Изменить метки потоковtrash_thread : Переместить тему в корзинуuntrash_thread : Удалить тему из корзиныdelete_thread : Удалить темуlist_drafts : Список черновиков в почтовом ящике пользователяget_draft : Получить конкретный черновик по идентификаторуcreate_draft : Создать черновик письма в Gmailupdate_draft : Заменить содержимое черновикаdelete_draft : Удалить черновикsend_draft : Отправить существующий черновикget_auto_forwarding : Получить настройки автоматической пересылкиupdate_auto_forwarding : Обновить настройки автоматической пересылкиget_imap : Получить настройки IMAPupdate_imap : Обновить настройки IMAPget_pop : Получить настройки POPupdate_pop : Обновить настройки POPget_vacation : Получить настройки автоответчика на время отпускаupdate_vacation : Обновление ответчика об отпускеget_language : Получить языковые настройкиupdate_language : Обновить языковые настройкиlist_delegates : Список делегатов аккаунтаget_delegate : Получить определенного делегатаadd_delegate : Добавить делегатаremove_delegate : Удалить делегатаlist_filters : Список фильтров электронной почтыget_filter : Получить определенный фильтрcreate_filter : Создать новый фильтрdelete_filter : Удалить фильтрlist_forwarding_addresses : Список адресов пересылкиget_forwarding_address : Получить определенный адрес пересылкиcreate_forwarding_address : Создать адрес пересылкиdelete_forwarding_address : Удалить адрес пересылкиlist_send_as : Список псевдонимов send-asget_send_as : Получить определенный псевдоним send-ascreate_send_as : Создать псевдоним send-asupdate_send_as : Обновить псевдоним send-aspatch_send_as : Частичное обновление псевдонима send-asverify_send_as : Отправить письмо с подтверждениемdelete_send_as : Удалить псевдоним send-aslist_smime_info : Список конфигураций S/MIMEget_smime_info : Получить определенную конфигурацию S/MIMEinsert_smime_info : загрузить новую конфигурацию S/MIMEset_default_smime_info : Установить конфигурацию S/MIME по умолчаниюdelete_smime_info : Удалить конфигурацию S/MIMEВклады приветствуются и поощряются! Пожалуйста, прочтите CONTRIBUTING.md для получения инструкций по вопросам, вкладам и контактной информации.
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Управляйте своими электронными письмами без усилий с помощью более 60 инструментов для составления, отправки, получения и организации сообщений. Оптимизируйте свои рабочие процессы электронной почты с помощью полного покрытия API Gmail, включая управление ярлыками и потоками.