Gmail Server for MCP Server

@MCP-Mirror

代码仓库

基本信息

分类

沟通协作

许可证

GPL-3.0 license

传输方式

stdio

作者

MCP-Mirror

关于 Gmail Server for MCP Server

Mirror of

#gmail #mcp#email-server

Gmail Server for MCP Server 配置

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

{
  "mcpServers": {
    "jasonsum_gmail-mcp-server": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "uv",
        "run",
        "[absolute-path-to-git-repo]/src/gmail/server.py",
        "--creds-file-path",
        "[absolute-path-to-credentials-file]",
        "--token-path",
        "[absolute-path-to-access-tokens-file]"
      ]
    }
  }
}

Gmail Server for MCP Server 工具

Sends email to email address recipient

Moves email to trash

Marks email as read

Retrieves unread emails

Retrieves given email content

Open email in browser

概览

What is Gmail Server for Model Context Protocol (MCP)?

This MCP server integrates with Gmail to enable sending, removing, reading, drafting, and responding to emails. The MCP client prompts the user before conducting such activities.

How to use Gmail Server for Model Context Protocol (MCP)?

First, set up a Google Cloud project, enable the Gmail API, configure an OAuth consent screen with test user, add OAuth scope https://www.googleapis.com/auth/gmail/modify, and create an OAuth Client ID for a Desktop App. Download the JSON credentials file and note its absolute path. Then configure an MCP client (e.g., Claude Desktop) using uv with parameters --creds-file-path and --token-path. On startup, a browser-based authentication flow saves token credentials to the specified token path.

Key features of Gmail Server for Model Context Protocol (MCP)

Send emails to a recipient with subject and content
Move emails to trash by ID
Mark emails as read by ID
Retrieve a list of unread emails
Fetch full content of a specific email (marks as read)
Open an email in the default browser by ID

Use cases of Gmail Server for Model Context Protocol (MCP)

An AI assistant sends an email on behalf of the user
Automatically trash or mark-as-read bulk messages
Read unread emails and summarize them for the user
Open a specific email in the browser for manual review

常见问题

What Gmail OAuth scopes are required?

The server uses `https://www.googleapis.com/auth/gmail.modify` which allows reading, sending, and modifying emails.

How is authentication handled?

On server start, a browser-based OAuth flow launches. Token credentials are saved to the file specified by `--token-path` and reused on subsequent runs.

What are the required dependencies?

A Google Cloud project with the Gmail API enabled, a Desktop App OAuth client, and `uv` for running the server. No Python dependencies beyond those bundled with the server are mentioned.

Where are credentials and tokens stored?

Credentials are stored in the file path given to `--creds-file-path`. Access and refresh tokens are stored in the file path given to `--token-path`. Both are local file paths on the user’s machine.

How is the server invoked?

The server is run via `uv run gmail --creds-file-path <path> --token-path <path>`. It communicates over stdio (standard MCP transport).

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

Upfirst

Upfirst is an AI phone receptionist for small businesses. Review call transcripts, then fix the greeting, knowledge, and transfer rules from your AI client.

Surgemesh

Novus Index LLC

Agent-first social publishing: exact quotes, then posts across networks, paid per post from prepaid credit. Remote MCP. Preview: quotes and sandbox posts now; live posts soon. By Novus Index LLC.

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.

ViewPrinter

VMGM Software

Schedule and publish social posts to TikTok, Instagram, Facebook, YouTube and X from your AI assistant. Connect an account once, then say what to post and when — ViewPrinter queues it, publishes it, and tells you what ha

SomaCheck Vibecheck

Sensie-agents

Body language for AI agents, on your terms. A consented three-second phone gesture gives your agent an Aligned or Unaligned signal with confidence. You remain the authority.