Gmail MCP B6b979f7

MCP办公协作

提供方 AkashDataScience

办公协作 stdio · 本地进程 OAuth 授权 社区 / 第三方
查看接入方式

一款基于Gemini AI和MCP协议的智能Gmail客户端,提供邮件分析、自动回复、垃圾邮件检测等功能。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

邮件管理Python本地部署人工智能Gmail集成自动化工具智能助手

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
pip install uv

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 6 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

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

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Gmail MCP B6b979f7当前 6 stdio · 本地进程 本地部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

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

详细介绍

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

Gmail MCP - AI-Powered Email Assistant

An intelligent Gmail client that uses MCP (Model Context Protocol) to interact with Gmail and Gemini AI to provide smart email management capabilities.

🌟 Features

  • 🤖 AI-Powered Email Analysis - Uses Gemini AI to analyze emails and determine appropriate actions
  • 📧 Complete Gmail Integration - Send, read, organize, and manage emails via Gmail API
  • 🔧 MCP Protocol - Modern client-server architecture using Model Context Protocol
  • 📊 Full Transparency - Complete logging of all AI interactions
  • 🎯 Smart Actions - Automatic replies, summaries, spam detection, and email organization
  • 💬 Interactive Interface - Command-line interface for easy email management

🏗️ Architecture```

┌─────────────────┐ MCP Protocol ┌─────────────────┐
│ talk2gmail.py │ ◄─────────────────► │ gmail/server.py │
│ (MCP Client) │ │ (MCP Server) │
│ │ │ │
│ • Gemini AI │ │ • Gmail API │
│ • User Interface│ │ • OAuth 2.0 │
│ • Command Parser│ │ • Email Tools │
└─────────────────┘ └─────────────────┘


## 📦 Components

### 1. **Gmail MCP Server** (`gmail/server.py`)
- Provides Gmail API integration via MCP tools
- Handles OAuth 2.0 authentication
- Exposes email operations as MCP tools

### 2. **Gmail MCP Client** (`talk2gmail.py`)
- Connects to Gmail MCP server
- Uses Gemini AI for intelligent email analysis
- Provides interactive command interface

## 🛠️ Available Gmail Tools

The MCP server provides these email management tools:

| Tool | Description | Parameters |
|------|-------------|------------|
| `send-email` | Send emails | `recipient_id`, `subject`, `message` |
| `get-unread-emails` | Retrieve unread emails | None |
| `read-email` | Get full email content | `email_id` |
| `trash-email` | Move emails to trash | `email_id` |
| `mark-email-as-read` | Mark emails as read | `email_id` |
| `open-email` | Open email in browser | `email_id` |

## 🚀 Quick Start

### Prerequisites

1. **Python 3.8+**
2. **uv** - Fast Python package manager (installation guide)
3. **Google Cloud Project** with Gmail API enabled
4. **Gemini API Key**

### Installation

1. **Install uv (if not already installed):**```bash
   # On macOS and Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh

   # On Windows
   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

   # Or with pip
   pip install uv
   ```

2. **Clone the repository:**```bash
   git clone <repository-url>
   cd gmail_mcp
   ```

3. **Install dependencies with uv:**```bash
   # Install all dependencies (recommended)
   uv sync

   # Or install with optional enhanced features
   uv sync --extra enhanced

   # Or install with development dependencies
   uv sync --extra dev
   ```

3. **Set up environment variables:**```bash
   # Create .env file
   echo "GEMINI_API_KEY=your_gemini_api_key_here" > .env
   ```

4. **Set up Gmail OAuth:**
   - Go to Google Cloud Console
   - Enable Gmail API
   - Create OAuth 2.0 credentials
   - Download credentials as `client_creds.json`

### First Run```bash
uv run python talk2gmail.py

On first run, you'll complete the OAuth flow:
1. Browser opens for Google authentication
2. Grant permissions to access Gmail
3. Token saved for future use

Alternative uv Commands```bash

Run with uv (recommended)

uv run python talk2gmail.py

Or activate virtual environment and run directly

uv shell
python talk2gmail.py


## 💻 Usage

### Example Queries```bash
# Natural language queries
📧 Enter your Gmail request: get my unread emails
📧 Enter your Gmail request: read the latest email from john@example.com
📧 Enter your Gmail request: send a thank you email to sarah@company.com

🤖 AI-Powered Features

Smart Email Analysis

The AI analyzes emails and determines actions:

  • REPLY - Generates contextual responses
  • SUMMARIZE - Creates concise summaries
  • URGENT - Flags important emails
  • SPAM - Detects and handles spam
  • ARCHIVE - Organizes routine emails

Example AI Analysis```

📧 Processing email: abc123
📖 From: client@company.com
📝 Subject: Project Update Required
🤖 AI Action: REPLY
💭 AI Reasoning: Client requesting project status - should provide update
✅ Reply sent: "Thank you for your inquiry. I'll provide the project update by end of day."


## 🔧 Configuration

### Environment Variables

Create a `.env` file:```env
GEMINI_API_KEY=your_gemini_api_key_here

Gmail Credentials

  1. Google Cloud Console Setup:
    - Create project
    - Enable Gmail API
    - Create OAuth 2.0 credentials
    - Add authorized redirect URIs: http://localhost:8080

  2. Download credentials as client_creds.json

Required Scopes

The application requires these Gmail scopes:
- https://www.googleapis.com/auth/gmail.modify

📁 Project Structure```

gmail_mcp/
├── gmail/
│ ├── init.py # Package entry point
│ └── server.py # Gmail MCP server
├── talk2gmail.py # Gmail MCP client
├── client_creds.json # Gmail OAuth credentials (you provide)
├── token.json # OAuth tokens (auto-generated)
├── .env # Environment variables (you create)
├── pyproject.toml # Project configuration and dependencies
├── requirements.txt # Python dependencies (legacy)
├── uv.lock # Dependency lock file (auto-generated)
└── README.md # This file
```

🔐 Security

  • OAuth 2.0 - Secure authentication with Google
  • Local Storage - Tokens stored locally, never transmitted
  • Minimal Scopes - Only requests necessary Gmail permissions
  • No Data Collection - All processing happens locally

Made with ❤️ using MCP (Model Context Protocol) and Gemini AI

常见问题

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

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

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

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

Gmail MCP B6b979f7 收费吗?

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

Gmail MCP B6b979f7 需要 API Key 吗?

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

Gmail MCP B6b979f7 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 邮件管理、人工智能、Python、Gmail集成。具体工具清单以官方文档为准。

Gmail MCP B6b979f7 需要什么运行环境?

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

Gmail MCP B6b979f7 是本地还是远程?

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

热门专题

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

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