关键词

Gmail集成邮件管理标签管理LLM工具扩展功能

项目简介

这是一个基于 Model Context Protocol (MCP) 的服务器，用于连接并暴露您的 Gmail 账户功能。通过这个服务器，大型语言模型 (LLM) 客户端可以安全地调用 Gmail API，实现邮件、标签等操作。

主要功能点

  • 获取您的 Gmail 账户标签列表。
  • 根据 ID 获取特定标签的详细信息。
  • 创建、更新和删除自定义标签。
  • 将指定邮件标记为已读或未读。
  • 为指定邮件添加一个或多个标签。
  • 将指定邮件或邮件列表移至垃圾箱。
  • 根据查询条件搜索邮件，并获取邮件 ID 列表（支持分页）。
  • 根据 ID 获取特定邮件的完整详情（包括头部信息和正文）。

安装步骤

  1. 确保您的系统已安装 Python 3.11 或更高版本，并安装了 'uv' 工具（推荐用于依赖管理）。
  2. 克隆项目仓库：'git clone https://github.com/ivanlhz/gmail-mcp-server.git'
  3. 进入项目目录：'cd gmail-mcp-server'
  4. 使用 'uv' 安装项目依赖：'uv pip install -r uv.lock'

服务器配置 (MCP 客户端配置)

您需要将此 MCP 服务器配置到您的 MCP 客户端中（例如 Claude Desktop）。配置通常是一个 JSON 格式的文件。以下是配置示例（您需要根据您的实际安装路径和 Google API 凭据进行修改）：

您的 MCP 客户端配置文件中需要包含类似如下的结构：

{
  "mcpServers": {
    "gmail": {
      "command": "/path/to/your/project/.venv/bin/gmail-mcp-server",
      "env": {
        "GOOGLE_CLIENT_ID": "您的Google Client ID",
        "GOOGLE_CLIENT_SECRET": "您的Google Client Secret"
      }
    }
  }
}
  • 'command': 指向项目虚拟环境中的 'gmail-mcp-server' 可执行文件路径。请根据您克隆项目和安装依赖的位置进行修改。
  • 'env': 包含 MCP 服务器运行所需的环境变量。
    • 'GOOGLE_CLIENT_ID': 从 Google Cloud Console 获取的 OAuth 2.0 客户端 ID。
    • 'GOOGLE_CLIENT_SECRET': 从 Google Cloud Console 获取的 OAuth 2.0 客户端密钥。

请注意，您需要先在 Google Cloud Console 创建凭据并启用 Gmail API，然后才能获取这些 ID 和密钥。详细步骤请参考项目的 README 文件。

基本使用方法

安装并配置好 MCP 服务器后，启动您的 MCP 客户端（如 Claude Desktop）。如果配置正确，客户端将自动启动并连接到 Gmail MCP 服务器。之后，您就可以在客户端中通过聊天或其他界面与 LLM 交互，LLM 将能够识别并调用 Gmail MCP 服务器暴露的功能（工具）来访问或操作您的 Gmail 账户。

信息

分类

生产力应用

访问项目