MCP 服务器

Gmail MCP Server

与 Gmail 集成，以通过模型上下文协议 (MCP) 发送、阅读、起草和管理电子邮件，从而允许用户通过自动化的客户端提示与电子邮件任务进行交互。

通信

本地

Python

访问服务器

README

用于模型上下文协议 (MCP) 的 Gmail 服务器

此 MCP 服务器与 Gmail 集成，以实现发送、删除、读取、起草和回复电子邮件的功能。

注意：此服务器允许 MCP 客户端读取、删除和发送电子邮件。但是，客户端在执行此类活动之前会提示用户。

https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90

组件

工具

send-email
- 向电子邮件地址收件人发送电子邮件
- 输入：
  - recipient_id (字符串): 收件人的电子邮件地址
  - subject (字符串): 电子邮件主题
  - message (字符串): 电子邮件内容
- 返回状态和 message_id
trash-email
- 将电子邮件移动到垃圾箱
- 输入：
  - email_id (字符串): 电子邮件的自动生成 ID
- 返回成功消息
mark-email-as-read
- 将电子邮件标记为已读
- 输入：
  - email_id (字符串): 电子邮件的自动生成 ID
- 返回成功消息
get-unread-emails
- 检索未读电子邮件
- 返回包含电子邮件 ID 的电子邮件列表
read-email
- 检索给定的电子邮件内容
- 输入：
  - email_id (字符串): 电子邮件的自动生成 ID
- 返回电子邮件元数据的字典并将电子邮件标记为已读
open-email
- 在浏览器中打开电子邮件
- 输入：
  - email_id (字符串): 电子邮件的自动生成 ID
- 返回成功消息并在默认浏览器中打开给定的电子邮件

设置

Gmail API 设置

创建一个新的 Google Cloud 项目
启用 Gmail API
配置 OAuth 同意屏幕
- 选择“外部”。但是，我们不会发布该应用。
- 将您的个人电子邮件地址添加为“测试用户”。
添加 OAuth 范围 https://www.googleapis.com/auth/gmail/modify
为应用程序类型“桌面应用”创建一个 OAuth 客户端 ID
下载客户端 OAuth 密钥的 JSON 文件
重命名密钥文件并将其保存到本地计算机上的安全位置。记下该位置。
- 启动服务器时，此文件的绝对路径将作为参数 --creds-file-path 传递。

身份验证

启动服务器时，将在您的系统浏览器中启动身份验证流程。令牌凭据将随后保存在传递给参数 --token-path 的绝对文件路径中（并在以后检索）。

例如，您可以使用主文件夹中的点目录，替换 [your-home-folder]：

参数	示例
`--creds-file-path`	`/[your-home-folder]/.google/client_creds.json`
`--token-path`	`/[your-home-folder]/.google/app_tokens.json`

与桌面应用程序一起使用

建议使用 uv。

要将此服务器与 Claude Desktop 集成作为 MCP 客户端，请将以下内容添加到应用程序的服务器配置中。默认情况下，它存储为 ~/Library/Application\ Support/Claude/claude_desktop_config.json。

{
  "mcpServers": {
    "gdrive": {
      "command": "uv",
      "args": [
        "--directory",
        "[absolute-path-to-git-repo]",
        "run",
        "gmail",
        "--creds-file-path",
        "[absolute-path-to-credentials-file]",
        "--token-path",
        "[absolute-path-to-access-tokens-file]"
      ]
    }
  }
}

必须设置以下参数

参数	示例
`--directory`	包含服务器的 `gmail` 目录的绝对路径
`--creds-file-path`	在 Gmail API 设置中创建的凭据文件的绝对路径。
`--token-path`	用于存储和检索应用程序的访问和刷新令牌的绝对路径。

使用 MCP Inspector 进行故障排除

要测试服务器，请使用 MCP Inspector。从 git 存储库中，运行以下命令，并相应地更改参数。

npx @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]