Berkeley Gmail MCP

MCPAI代理

提供方 kope-kope · 包名 @modelcontextprotocol/inspector

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaude
查看接入方式

为UC Berkeley的Gmail用户提供通过Claude直接访问、阅读、起草、发送和管理邮件的服务。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

邮件管理Python本地部署Gmail集成AI助手自动化

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector uv run /absolute/path/to/berkeley-gmail-mcp/src/gmail/server.py \

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

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

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Berkeley Gmail MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

Gmail MCP服务器——加州大学伯克利分校

让克劳德直接访问您的伯克利Gmail(@Berkeley.edu),这样您就可以在不离开人工智能助手的情况下阅读、起草、发送和管理电子邮件。

> 注: 克劳德在发送或删除电子邮件之前,总是会要求您确认。


它能做什么?

  • 阅读 您未读的电子邮件
  • 起草并发送 电子邮件(可选HTML格式和文件附件)
  • 垃圾 电子邮件
  • 马克 电子邮件已读
  • 打开 直接在浏览器中发送任何电子邮件

先决条件

在开始之前,请确保您已经:

  • Python 3.12或更高版本 安装
  • macOS、Linux或Windows与WSL
  • A. 伯克利电子邮件帐户 (@berkeley.edu)
  • 克劳德桌面版 安装
  • 访问 伯克利谷歌云端硬盘 (用于凭证)

设置

1.克隆仓库```bash

git clone https://github.com/kope-kope/berkeley-gmail-mcp.git
cd berkeley-gmail-mcp


### 2.下载凭据文件

下载 `client_creds.json` 从 Google 云端硬盘 并将其保存在项目根目录中。

> 您必须登录到您的 `@berkeley.edu` 帐户访问此文件。

### 3.配置您的显示名称

复制示例配置并填写您的姓名:```bash
cp config.example.json config.json

编辑 config.json:```json
{
"display_name": "Your Name"
}


这将设置中显示的显示名称 **自** 您发送的电子邮件字段。这是可选的——如果你跳过它,电子邮件将从你的原始电子邮件地址发出。

> **永不承诺 `config.json` 或您的凭据文件。** 它们在这个回购中是合法的。

### 4.创建令牌文件占位符```bash
touch app_tokens.json

此文件将在首次身份验证期间自动填充。

5.安装uv

紫外线 是运行服务器的推荐方式:```bash
curl -LsSf https://astral.sh/uv/install.sh | sh


### 6.连接到克劳德桌面

将以下内容添加到您的Claude Desktop配置中 `~/Library/Application Support/Claude/claude_desktop_config.json`:```json
{
"mcpServers": {
"gmail": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/berkeley-gmail-mcp",
"run",
"gmail",
"--creds-file-path",
"/absolute/path/to/berkeley-gmail-mcp/client_creds.json",
"--token-path",
"/absolute/path/to/berkeley-gmail-mcp/app_tokens.json",
"--config-path",
"/absolute/path/to/berkeley-gmail-mcp/config.json"
]
}
}
}

替换 /absolute/path/to/berkeley-gmail-mcp 使用机器上的实际绝对路径。例如:

参数 示例路径
--directory /Users/yourname/berkeley-gmail-mcp
--creds-file-path /Users/yourname/berkeley-gmail-mcp/client_creds.json
--token-path /Users/yourname/berkeley-gmail-mcp/app_tokens.json
--config-path /Users/yourname/berkeley-gmail-mcp/config.json

7.身份验证

Claude第一次启动服务器时,会打开一个浏览器窗口,要求您登录。 用你的 @berkeley.edu 账户 之后,您的令牌将保存在本地并自动重复使用。


用法

一旦通过身份验证,您就可以通过Claude Desktop与您的Gmail进行交互。以下是一些示例提示:

  • “显示我的未读电子邮件”
  • “起草一封电子邮件至professor@berkeley.edu关于办公时间”
  • “发送我们刚刚起草的电子邮件”
  • “在浏览器中打开昨天的电子邮件”
  • “将该垃圾邮件移至垃圾箱”

> 注: 克劳德在发送或删除电子邮件之前总是会要求确认。

高级功能

  • HTML电子邮件:起草时,您可以要求Claude将电子邮件格式化为HTML格式
  • 附件:您可以指定要附加到电子邮件的文件路径
  • 多个收件人:您可以同时向多人发送电子邮件

故障排除

常见问题

服务器无法启动

  • 错误:“没有名为'gmail'的模块” → Run uv sync 在项目目录中安装依赖项
  • 错误:“找不到文件:client_creds.json” → 确保您已下载该文件,并且它位于项目根目录中
  • 错误:“权限被拒绝” → 检查项目目录上的文件权限

身份验证问题

  • 浏览器无法打开 → 手动访问终端中显示的URL
  • “访问被阻止” → 确保您使用您的@berkeley.edu帐户登录
  • 令牌已过期 → 删除 app_tokens.json 并重新验证

电子邮件操作

  • “没有未读邮件”,但你有一些 → 检查它们是否在您的收件箱中(未存档)
  • 附件未发送 → 验证文件路径是否为绝对路径以及文件是否存在
  • 电子邮件未出现在已发送文件夹中 → 检查“消息发送成功”确认和消息ID

使用MCP检查器进行调试

使用 MCP检查员 直接测试服务器:```bash
npx @modelcontextprotocol/inspector uv run /absolute/path/to/berkeley-gmail-mcp/src/gmail/server.py \
--creds-file-path /absolute/path/to/berkeley-gmail-mcp/client_creds.json \
--token-path /absolute/path/to/berkeley-gmail-mcp/app_tokens.json \
--config-path /absolute/path/to/berkeley-gmail-mcp/config.json


______________________________________________________________________

## 安全

### 最佳实践

- **永不承诺** `client_creds.json`, `app_tokens.json`,或 `config.json` 到版本控制(它们被忽略)
- **存储凭据文件** 安全地限制权限(`chmod 600 *.json` 在项目目录中)
- **检查代码** 在运行之前,此服务器已修改您的Gmail访问权限
- **保护令牌文件** 就像密码一样,它们包含OAuth凭据
- **撤销访问权限** 在你的 Google帐户设置 如果您怀疑凭据已泄露

### 访问哪些数据?

此服务器请求 `gmail.modify` 范围,允许:

- 读取电子邮件元数据和内容
- 代表您发送电子邮件
- 将电子邮件移至垃圾箱
- 将电子邮件标记为已读

服务器 **不** 永久删除电子邮件或访问垃圾箱中的电子邮件。

______________________________________________________________________

## 发展

### 在当地发展

1. 克隆存储库并导航到项目目录
1. 安装依赖项(包括开发依赖项):```bash
uv sync --extra dev
  1. 直接运行服务器:```bash
    uv run python src/gmail/server.py \
    --creds-file-path /path/to/client_creds.json \
    --token-path /path/to/app_tokens.json \
    --config-path /path/to/config.json

### 项目结构```
berkeley-gmail-mcp/
├── src/gmail/
│   ├── __init__.py      # Entry point and CLI argument parsing
│   └── server.py        # Core MCP server and Gmail API integration
├── config.example.json  # Example configuration
├── config.json          # Your config (gitignored)
├── client_creds.json    # OAuth credentials (gitignored)
├── app_tokens.json      # Auth tokens (gitignored, auto-generated)
├── pyproject.toml       # Project dependencies and metadata
├── LICENSE              # GPL-3.0 license
└── README.md            # This file

代码风格

本项目使用:

  • 黑色 用于代码格式化(行长:100)
  • 米皮 用于类型检查
  • 拉夫 对于linting
  • pytest 用于测试

运行格式化和检查:bash uv run black src/ uv run mypy src/ uv run ruff check src/

贡献

看 贡献.md 了解如何为这个项目做出贡献的指导方针。


常见问题解答

Q: 多个人可以使用同一个吗 client_creds.json 文件?
A: 是的!这 client_creds.json 文件是Berkeley Gmail应用程序的OAuth客户端凭据。多个用户可以共享此文件。每个用户将生成自己的 app_tokens.json 当他们进行身份验证时。

Q: 我可以使用非伯克利Gmail帐户吗?
A: 不提供 client_creds.json 文件,因为它是专门为@berkeley.edu帐户配置的。但是,您可以在Google Cloud Console中为其他帐户创建自己的OAuth凭据。

Q: 此服务器请求什么Gmail范围?
A: 服务器请求 gmail.modify,它允许阅读、发送电子邮件和将电子邮件移动到垃圾桶。确实如此 不 请求 gmail.readonly 或 gmail.compose --它需要修改访问权限,将电子邮件标记为已读并将其丢弃。

Q: 这在手机上有效吗?
A: 不,这是Claude Desktop的服务器,它是一个桌面应用程序。但是,通过服务器发送的电子邮件将显示在所有设备上的Gmail中。

Q: 如何撤销访问权限?
A: 访问您的 Google帐户权限页面,找到“Berkeley Gmail MCP”,然后单击“删除访问权限”。然后删除您的 app_tokens.json 文件。

Q: 为什么用uv代替pip?
A. 紫外线 比pip(10-100x)快得多,自动创建隔离环境,并通过以下方式提供可重复的构建 uv.lock。它还简化了部署 uv run.


许可证

此项目根据GNU通用公共许可证v3.0或更高版本获得许可。看 许可证 了解详情。

常见问题

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

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector uv run /absolute/path/to/berkeley-gmail-mcp/src/gmail/server.py \。对应的包名是 @modelcontextprotocol/inspector。装完在客户端配置里引用同一个包或端点。

Berkeley Gmail MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Berkeley Gmail MCP 收费吗?

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

Berkeley Gmail MCP 需要 API Key 吗?

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

Berkeley Gmail MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Berkeley Gmail MCP 能提供哪些能力?

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

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

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

Berkeley Gmail MCP 是本地还是远程?

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

热门专题

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

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