广告合作
MCP.so
登录

MCP Headless Gmail Server

@baryhuang

代码仓库

基本信息

分类

沟通协作

许可证

MIT

传输方式

stdio

作者

baryhuang

关于 MCP Headless Gmail Server

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

#mcp#gmail#google-suite#gmail-bot#ai-assistant#mcp-server

MCP Headless Gmail Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-headless-gmail": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp-headless-gmail",
        "."
      ]
    }
  }
}

MCP Headless Gmail Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Headless Gmail Server?

A Model Context Protocol (MCP) server that provides get, send, and refresh Gmail functionality without requiring local credential or token setup. It is designed for headless, remote environments and decouples credential storage from server implementation.

How to use MCP Headless Gmail Server?

Install via pip install -e . or use the Docker image buryhuang/mcp-headless-gmail:latest. Configure an MCP client like Claude Desktop with either the Docker or npx command shown in the README. Provide your Google API credentials (client ID, client secret, access token, refresh token) via tool calls. Start by refreshing the token with gmail_refresh_token, then use tools such as get_recent_emails, get_email_body, and send_email.

Key features of MCP Headless Gmail Server

  • Get recent emails with first 1k characters of body.
  • Retrieve full email body in 1k-character chunks via offset.
  • Send emails through Gmail with plain text or HTML body.
  • Refresh access tokens separately or automatically when expired.
  • Run completely headless in remote environments (no browser, no local files).
  • Docker-ready for isolated, one-click deployment.

Use cases of MCP Headless Gmail Server

  • Automate reading and responding to emails from an AI assistant.
  • Send Gmail messages directly from MCP-enabled clients like Claude Desktop.
  • Integrate Gmail access into marketing or notification workflows without local credential storage.
  • Deploy a stateless Gmail service in containerised or cloud environments.

常见问题

1

What are the prerequisites?

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

2

How do I obtain Google API credentials?

Create a project in the Google Cloud Console, enable the Gmail API, configure the OAuth consent screen, create an OAuth client ID (Desktop app type), and use OAuth 2.0 to obtain tokens with scopes `gmail.readonly` and `gmail.send`.

3

How does token refresh work?

The server provides a `gmail_refresh_token` tool that accepts either full credentials or just a refresh token with client ID/secret. It returns a new access token. Automatic refresh is also handled by the underlying Google API client when the access token expires.

4

Can this server run inside Docker?

Yes. The Docker image can be built with `docker build -t mcp-headless-gmail .` and run with a `docker run` command. Configuration for Claude Desktop using Docker is provided in the README.

5

What scopes are required for the Gmail API?

The server requires `https://www.googleapis.com/auth/gmail.readonly` for reading emails and `https://www.googleapis.com/auth/gmail.send` for sending emails.

评论

沟通协作 分类下的更多 MCP 服务器

HelpWell

Workado, LLC

HelpWell connects AI assistants to your help desk, knowledge base, live chat support and email marketing automation for SaaS. Triage support tickets, draft help docs and replies, manage contacts, and prepare newsletters

Atomic Mail Agentic

Atomic-Mail

Let your agents read, send and react to email autonomously, without human involvement

255

Faivelo Email

Benjamin Brookarsh

Business email on your own domain for AI agents. Read, search and send mail, manage mailboxes and aliases, and set up DNS automatically, with unlimited mailboxes on one flat plan.

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

1

atbridge.ai

atbridge-ai

Local MCP server for Thunderbird. Gives Claude Desktop, Cursor, or any MCP client read/write access to multiple mailboxes, calendars, contacts, notes & tasks (Gmail, Outlook, IMAP) — all on your machine.

广告合作