Gmail MCP 372db567

MCP安全风控

提供方 PeterAkande

安全风控 stdio · 本地进程 OAuth 授权 社区 / 第三方
查看接入方式

一个全面的Gmail操作模型上下文协议(MCP)服务器,提供25种生产就绪工具和可流式传输的HTTP传输。

一句话选型结论

按资料字段整理

Gmail MCP 372db567 属于安全风控类 MCP 服务器,stdio · 本地进程,OAuth 授权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 4 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

Gmail集成Python本地部署邮件管理OAuth认证类型安全HTTP流传输

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
uv run python start_server.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Gmail MCP 372db567当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方PeterAkande上游标注的维护方 PeterAkande
分类安全风控本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.5 KB
来自项目仓库与上游目录的原文,未做删改

Gmail MCP Server

A comprehensive Model Context Protocol (MCP) server for Gmail operations with 25 production-ready tools and streamable HTTP transport.

🚀 Quick Start

Prerequisites```bash

Install uv (Python package manager)

curl -LsSf https://astral.sh/uv/install.sh | sh


### Installation```bash
# Clone and install dependencies
git clone <repository>
cd gmail_mcp
uv sync

Development Setup```bash

Copy environment template

cp .env.example .env

Edit .env with your configuration (see Configuration section)

Start development server (auto-reload)

uv run python start_server.py

OR manually with custom port

uvicorn main:app --reload --port 8002


## Features

### Complete Gmail Integration
- **25 MCP Tools** covering all Gmail operations
- **OAuth 2.0 Authentication** with Google token validation
- **Type Safety** with comprehensive Pydantic models

## Tools available (25 Total)

- `gmail_get_emails` - List emails with filtering, pagination, and date ranges
- `gmail_get_my_sent_emails` - Get sent emails with date filtering
- `gmail_get_email_by_id` - Get specific email by ID with format options
- `gmail_search_emails` - Advanced search with Gmail query syntax and date ranges
- `gmail_get_labels` - List all Gmail labels and their properties
- `gmail_get_profile` - Get Gmail profile and account information
- `gmail_send_email` - Send new emails with attachments and formatting
- `gmail_reply_to_email` - Reply to emails with options for reply-all
- `gmail_mark_as_read` / `gmail_mark_as_unread` - Manage read status
- `gmail_archive_email` / `gmail_unarchive_email` - Archive management
- `gmail_delete_email` - Delete emails (move to trash)
- `gmail_add_label` / `gmail_remove_label` - Manage email labels
- `gmail_create_label` - Create new custom labels
- `gmail_forward_email` - Forward emails with additional message
- `gmail_move_to_folder` - Move emails between folders/labels
- `gmail_get_threads` - List conversation threads with date filtering
- `gmail_get_thread_by_id` - Get specific thread by ID
- `gmail_create_draft` - Create draft emails
- `gmail_get_drafts` - List draft emails with date filtering
- `gmail_get_draft_by_id` - Get specific draft by ID
- `gmail_send_draft` - Send existing drafts
- `gmail_get_attachments` - Download email attachments

## Configuration

### Environment Variables (.env)```bash
# Server Configuration
SERVER_HOST=0.0.0.0                    # Server bind address
SERVER_PORT=8001                       # Server port
SERVER_URL=http://localhost:8001       # This server's URL for OAuth validation
DEBUG=false                            # Enable debug mode

# Transport Configuration
TRANSPORT_TYPE=streamble_http           # streamble_http or sse
MCP_SERVER_NAME=gmail_mcp_server       # MCP server identifier

# Logging
LOG_LEVEL=INFO                         # DEBUG, INFO, WARNING, ERROR
LOG_FORMAT=%(asctime)s - %(name)s - %(levelname)s - %(message)s

OAuth Scopes

The server requires these Gmail scopes:
- gmail.readonly - Read emails and labels
- gmail.send - Send emails
- gmail.modify - Modify emails (archive, label, etc.)
- gmail.compose - Create drafts
- gmail.labels - Manage labels

Message Formats (For when Getting emails)

The server supports 5 message formats for optimal performance:

COMPACT (Default)

  • Best for: General email browsing and AI processing
  • Contains: Headers + plain text body + metadata
  • Use case: Most common operations

MINIMAL

  • Best for: Listing and enumeration
  • Contains: ID, labels, snippet only
  • Use case: High-volume operations

FULL

  • Best for: Complete email reading
  • Contains: All data including HTML, attachments
  • Use case: Display full emails

METADATA

  • Best for: Header analysis
  • Contains: All headers, no body content
  • Use case: Email analysis without content

RAW

  • Best for: Email processing
  • Contains: Original RFC2822 format
  • Use case: Migration, backup

Date Range Filtering

Most tools support flexible date filtering:

Absolute Dates```python

YYYY-MM-DD or YYYY/MM/DD format

after_date="2024-01-01"
before_date="2024-12-31"


### **Relative Timeframes**```python
# Days, weeks, months, years
newer_than="1d"    # Last day
older_than="6m"    # Older than 6 months

Examples```python

Get recent important emails

gmail_get_emails(label_ids=["IMPORTANT"], newer_than="1w", format="COMPACT")

Search emails in date range

gmail_search_emails(query="project", after_date="2024-06-01", before_date="2024-06-30")


## Architecture

### **MCP Server Design**
- **Transport**: Streamable HTTP (default) or SSE
- **Authentication**: Google OAuth 2.0 with token validation
- **Format**: JSON-based MCP protocol
- **Streaming**: Real-time response streaming for large operations

### **OAuth Flow**```
┌─────────────────────┐    ┌──────────────────────┐    ┌─────────────────┐
│   MCP Client        │    │   Google OAuth       │    │  Gmail MCP      │
│                     │    │   (accounts.google)  │    │  Server         │
│ 1. Request with     │────│ 2. Validates token   │────│ 3. Gmail API    │
│    Bearer token     │    │    Returns user info │    │    operations   │
│                     │    │                      │    │                 │
└─────────────────────┘    └──────────────────────┘    └─────────────────┘

API Reference

Authentication

All endpoints require a valid Google OAuth token:```http
Authorization: Bearer <google_oauth_token>


## Development

### **Project Setup**```bash
# Install dependencies
uv sync

# Setup environment
cp .env.example .env
# Edit .env file with your configuration

# Run tests
uv run python mail_test_main.py

# Start development server with auto-reload
uv run python start_server.py

Development Commands```bash

Development server (auto-reload)

uv run python start_server.py

Manual development with custom port

uvicorn main:app --reload --port 8002

Production server

uvicorn main:app --host 0.0.0.0 --port 8001

Run interactive tests

uv run python mail_test_main.py


### **Testing Tools**
The project includes `service_example/service_functions_test.py` - an interactive test suite:
- Tests all 25 Gmail Service functions

### **Gmail OAuth Scopes**
The server automatically configures these required scopes:```python
REQUIRED_SCOPES = [
    &quot;https://www.googleapis.com/auth/gmail.readonly&quot;,
    &quot;https://www.googleapis.com/auth/gmail.send&quot;,
    &quot;https://www.googleapis.com/auth/gmail.modify&quot;,
    &quot;https://www.googleapis.com/auth/gmail.compose&quot;,
    &quot;https://www.googleapis.com/auth/gmail.labels&quot;
]

🔐 Google OAuth Setup

  1. Google Cloud Console
    - Create project at console.cloud.google.com
    - Enable Gmail API
    - Create OAuth 2.0 credentials

  2. OAuth Configuration
    - Add authorized origins: http://localhost:8001
    - Add redirect URIs as needed for your OAuth flow
    - Download credentials (not stored in this server)

  3. Token Validation
    - This server validates tokens with Google's accounts.google.com - For getting an access token for quick test, checkservice_example/get_access_token.py
    - No credential storage - tokens validated per request

📝 License

MIT License - see LICENSE file for details.

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Gmail MCP 372db567 怎么安装?

在客户端按下面的安装命令接入:uv run python start_server.py。装完在客户端配置里引用同一个包或端点。

Gmail MCP 372db567 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Gmail MCP 372db567 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Gmail MCP 372db567 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Gmail MCP 372db567 能提供哪些能力?

资料显示能力标签包括 Gmail集成、类型安全、Python、邮件管理。具体工具清单以官方文档为准。

Gmail MCP 372db567 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Gmail MCP 372db567 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。