Gmail MCP服务器

Gmail MCP服务器设置

概述

此项目创建了一个模型上下文协议（MCP）服务器，允许Claude（或任何兼容MCP的客户端）与您的Gmail帐户进行交互。它支持：

• 发送电子邮件（带附件和不带附件）
• 创建草稿
• 列出、阅读、删除和修改Gmail邮件
• 管理标签
• 提取元数据，如标题、正文、发件人、收件人等。
• 还有更多

技术栈

• python
• 谷歌Gmail API
• 谷歌认证/OAuth2
• MCP协议（通过 fastmcp)
• Claude桌面集成
• 虚拟环境(.venv)使用 uv 或Python

安装说明

1.克隆或导航到项目目录

例子：

cd ~/Desktop/GmailMCPServer

2.创建并激活虚拟环境

使用 uv:

uv venv --python $(which python3)
source .venv/bin/activate

或使用内置 venv:

python3 -m venv .venv
source .venv/bin/activate

3.安装所需的软件包

pip install -r requirements.txt

4.设置Google Cloud凭据

1. 首选 谷歌云控制台 并创建一个新项目
2. 启用 Gmail API
3. 创建一个 OAuth 2.0客户端ID 为了一个 Web应用程序
4. 下载 credentials.json 文件
5. 将其放置在项目目录的根目录下（例如）：

~/Desktop/GmailMCPServer/credentials.json

6. 将您的电子邮件添加为GCP中的测试用户
7. 在项目配置中添加相应的重定向URI

5.克劳德桌面MCP配置

创建或更新此文件：

~/Library/Application Support/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "{{PROJECT_NAME}}": {
            "command": "{{PATH_TO_PROJECT}}/.venv/bin/python",
            "args": [
                "{{PATH_TO_PROJECT}}/main.py"
            ],
	}
    }
}

替换 {{PATH_TO_PROJECT}} 通过： cd进入包含源代码的文件夹并复制 pwd 命令。

6.首次生成OAuth2令牌

运行以下命令一次以进行身份验证并生成 token.json:

python main.py

浏览器将打开以授权访问。成功后，a token.json 文件将被保存。

7.克劳德用法

MCP服务器运行后，您可以发出以下自然语言命令：

Send an email draft from ***@gmail.com to ***@gmail.com saying subject "hello" and body "test"

Claude将根据上下文使用适当的工具。

备注

• 你必须保持 credentials.json 以及生成的 token.json 安全。