shinzo-labs/gmail-mcp

Gmail MCP сервер

Реализация сервера Model Context Protocol (MCP) для API Gmail, обеспечивающего стандартизированный интерфейс для управления электронной почтой, отправки и поиска.

Особенности

Полное покрытие API Gmail, включая сообщения, потоки, ярлыки, черновики и настройки Поддержка отправки, составления и управления электронной почтой

• Управление этикетками с настраиваемыми цветами и настройками видимости
• Операции потока для управления разговором
• Управление настройками, включая реагирование на отпуск, IMAP / POP и языковые настройки Отслеживание истории изменений почтового ящика Безопасная аутентификация OAuth2 с использованием учетных данных Google Cloud

Предпосылки

Зависимости

Для простейшей установки установите Node.js 18+. Если вы хотите построить локально, вам также необходимо установить pnpm.

Настройка рабочего пространства Google

Чтобы запустить этот MCP-сервер, вам нужно будет настроить клиент API Google для вашей организации, при этом каждый пользователь запустит скрипт для извлечения своего собственного токена обновления OAuth.

Настройка клиента Google API (один раз в организации)

1 Перейдите в Google Cloud Console. 2.Создать новый проект или выбрать существующий. 3.Включить API Gmail для вашего проекта. 4.

A Model Context Protocol (MCP) server implementation for the Gmail API, providing a standardized interface for email management, sending, and retrieval.

Features

• Complete Gmail API coverage including messages, threads, labels, drafts, and settings
• Support for sending, drafting, and managing emails
• Label management with customizable colors and visibility settings
• Thread operations for conversation management
• Settings management including vacation responder, IMAP/POP, and language settings
• History tracking for mailbox changes
• Secure OAuth2 authentication using Google Cloud credentials

Prerequisites

Dependencies

For simplest installation, install Node.js 18+. If you would like to build locally, you will also need to install pnpm.

Google Workspace Setup

To run this MCP server, you will need to set up a Google API Client for your organization, with each user running a script to retrieve their own OAuth refresh token.

Google API Client Setup (once per organization)

1. Go to the Google Cloud Console.
2. Create a new project or select an existing one.
3. Enable the Gmail API for your project.
4. Go to Credentials and create an OAuth 2.0 Client ID. Choose “Desktop app” for the client type.
5. Download and save the OAuth keys JSON as ~/.gmail-mcp/gcp-oauth.keys.json. ⚠️ NOTE: to create ~/.gmail-mcp/ through MacOS’s Finder app you need to enable hidden files first.
6. (Optional) For remote server installation (ex. using Smithery CLI), note the CLIENT_ID and CLIENT_SECRET from this file.