Сервер MCP (Model Context Protocol), который обеспечивает получение, отправку Gmail без локальных учетных данных или настройки токена.

Почему MCP Headless Gmail Server?

Критические преимущества

Безголовая и дистанционная операция: В отличие от других решений MCP Gmail, которые требуют работы за пределами докера и локального доступа к файлам, этот сервер может работать без головы в удаленных средах без браузера и локального доступа к файлам. Разъединенная архитектура: Любой клиент может самостоятельно завершить поток OAuth, а затем передать учетные данные в качестве контекста на этот сервер MCP, создавая полное разделение между хранением учетных данных и реализацией сервера.

###Хорошо, но не критично **Функциональность : Во многих случаях использования, особенно для маркетинговых приложений, требуется только доступ к Gmail без дополнительных сервисов Google, таких как Календарь. Docker-Ready: разработан с учетом контейнеризации для хорошо изолированной, независимой от окружающей среды установки с одним щелчком мыши. ** Надежные зависимости: Построена на хорошо обслуживаемой библиотеке google-api-python-клиентов.

Особенности

Получите последние электронные письма от Gmail с первыми 1k символами тела

MCP Headless Gmail Server (NPM & Docker)

A MCP (Model Context Protocol) server that provides get, send Gmails without local credential or token setup.

Why MCP Headless Gmail Server?

Critical Advantages

• Headless & Remote Operation: Unlike other MCP Gmail solutions that require running outside of docker and local file access, this server can run completely headless in remote environments with no browser no local file access.
• Decoupled Architecture: Any client can complete the OAuth flow independently, then pass credentials as context to this MCP server, creating a complete separation between credential storage and server implementation.

Nice but not critical

• Focused Functionality: In many use cases, especially for marketing applications, only Gmail access is needed without additional Google services like Calendar, making this focused implementation ideal.
• Docker-Ready: Designed with containerization in mind for a well-isolated, environment-independent, one-click setup.
• Reliable Dependencies: Built on the well-maintained google-api-python-client library.

Features

• Get most recent emails from Gmail with the first 1k characters of the body
• Get full email body content in 1k chunks using offset parameter
• Send emails through Gmail
• Refresh access tokens separately
• Automatic refresh token handling

Prerequisites

• Python 3.10 or higher
• Google API credentials (client ID, client secret, access token, and refresh token)

Installation

# Clone the repository
git clone https://github.com/baryhuang/mcp-headless-gmail.git
cd mcp-headless-gmail

# Install dependencies
pip install -e .

Docker

Building the Docker Image

# Build the Docker image
docker build -t mcp-headless-gmail .

Usage with Claude Desktop

You can configure Claude Desktop to use the Docker image by adding the following to your Claude configuration:

docker

{
  "mcpServers": {
    "gmail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-headless-gmail:latest"
      ]
    }
  }
}

npm version

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