MCP (Model Context Protocol) 서버는 로컬 credential 또는 토큰 설정 없이 Gmail을 전송합니다.

왜 MCP 헤드리스 Gmail 서버?

긴요한 이점

• **Headless & 리모트 운영 **: 다른 MCP Gmail 솔루션과는 달리 Docker와 Local 파일 액세스 밖에 달리, 이 서버는 브라우저의 로컬 파일 액세스가 필요없는 원격 환경에서 완전 헤드리스를 실행할 수 있습니다.
• Decoupled Architecture: 모든 클라이언트는 독립적으로 OAuth 흐름을 완료 할 수 있습니다, 다음이 MCP 서버에 상황에 따라 자격 증명을 통과, 자격 저장과 서버 구현 사이의 완전한 분리를 생성.

Nice 하지만 중요하지 않음

• Focused 기능: 많은 사용 사례, 특히 마케팅 응용 프로그램에 대 한, Gmail 액세스는 캘린더와 같은 추가 Google 서비스 없이 필요, 이 집중된 구현 이상.
• Docker-Ready: 잘 격리된, 환경 독립, 원클릭 설정에 대한 마음으로 컨테이너화 설계. -Reliable Dependencies: 잘 알려진 Google-api-python-client 라이브러리에 내장.

특징

• 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"
      ]
    }
  }
}