使用说明

项目简介

Gmail Integration Server (gmail-mcp) 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为 Claude Desktop 提供 Gmail 和 Google 日历的集成能力。通过此服务器，Claude Desktop 可以安全、可扩展地访问您的 Gmail 数据和日历功能，从而实现更智能、上下文感知的邮件处理和日程管理。

主要功能点

深度邮件分析：提供完整邮件会话线程的上下文信息，包括历史邮件内容。
上下文感知回复：基于完整的邮件沟通历史生成更贴切的回复建议。
智能操作建议：分析邮件内容，识别日历事件、任务和待办事项，并提供智能建议。
日历集成：检测邮件中的事件信息，并支持使用自然语言创建日历条目。
高级搜索：支持在整个邮件历史记录中进行语义理解的搜索。
个性化定制：能够学习和适应您的沟通风格，针对特定联系人提供更个性化的交互。

安装步骤

手动安装 (推荐)：

克隆仓库到本地：

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

创建并激活虚拟环境 (推荐使用 uv)：

pip install uv
uv venv
source .venv/bin/activate  # 或 .venv\Scripts\activate (Windows)

安装项目依赖：
```
uv pip install -e .
```

通过 Smithery 安装 (自动安装)：

如果您使用 Smithery，可以使用以下命令自动安装：

npx -y @smithery/cli install @bastienchabal/gmail-mcp --client claude

服务器配置

要将 Gmail Integration Server 配置为 Claude Desktop 的 MCP 服务器，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。

配置文件路径：'/Users/<用户名>/Library/Application Support/Claude/claude_desktop_config.json'

配置内容：将以下 JSON 代码添加到 'mcpServers' 字段中。请根据您的实际安装路径和 Google OAuth 凭据进行修改。

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "/<您的gmail-mcp绝对路径>/gmail-mcp/.venv/bin/mcp",
      "args": [
        "run",
        "/<您的gmail-mcp绝对路径>/gmail-mcp/gmail_mcp/main.py:mcp"
      ],
      "cwd": "/<您的gmail-mcp绝对路径>/gmail-mcp",
      "env": {
        "PYTHONPATH": "/<您的gmail-mcp绝对路径>/gmail-mcp",
        "CONFIG_FILE_PATH": "/<您的gmail-mcp绝对路径>/gmail-mcp/config.yaml",
        "GOOGLE_CLIENT_ID": "<您的Google OAuth客户端ID>",
        "GOOGLE_CLIENT_SECRET": "<您的Google OAuth客户端密钥>",
        "TOKEN_ENCRYPTION_KEY": "<您生成的随机加密密钥>"
      }
    }
  }
}

参数说明：

'command': 'mcp' 启动命令的绝对路径，通常位于项目虚拟环境的 'bin' 目录下。
'args': 'mcp run' 命令的参数，指定了 MCP 应用的入口点。
'cwd': 工作目录，设置为 'gmail-mcp' 项目的根目录。
'env': 环境变量配置，包含：
- 'PYTHONPATH': Python 模块搜索路径，指向 'gmail-mcp' 项目根目录。
- 'CONFIG_FILE_PATH': 'config.yaml' 配置文件的路径，通常位于项目根目录。
- 'GOOGLE_CLIENT_ID': 您的 Google OAuth 客户端 ID，从 Google Cloud Console 获取。
- 'GOOGLE_CLIENT_SECRET': 您的 Google OAuth 客户端密钥，从 Google Cloud Console 获取。
- 'TOKEN_ENCRYPTION_KEY': 用于加密 OAuth 令牌的密钥，您可以使用命令 'python -c "import os; from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"' 生成。

重要提示：请务必将 '<您的gmail-mcp绝对路径>'、'<您的Google OAuth客户端ID>'、'<您的Google OAuth客户端密钥>' 和 '<您生成的随机加密密钥>' 替换为实际值。

基本使用方法

启动 Claude Desktop 客户端。
在 Claude Desktop 中，您可以像平常一样输入提示语。当 Claude 需要访问您的 Gmail 或日历信息时，会自动连接到 Gmail Integration Server。
首次使用时，Claude 会请求您进行 Google 账号身份验证。按照提示完成验证流程即可。
您可以使用自然语言指令来操作 Gmail 和日历，例如：
- "显示我的收件箱概览"
- "查找我老板关于季度报告的所有未读邮件"
- "帮我回复 Sarah 关于项目截止日期的最后一封邮件"
- "在日历上创建一个团队会议事件，会议内容是 John 的邮件里提到的"
- "下周我有哪些会议安排？"
- "分析这封邮件线程，帮我理解重点，以便回复"
- "根据我之前和这个人沟通的风格，草拟一封回复邮件"

注意：此 MCP 服务器配置为在执行任何重要操作（例如发送电子邮件或创建会议）之前，始终需要您进行确认。

关键词

Gmail, Google日历, 邮件管理, 日程安排, Claude Desktop, 上下文感知, 智能助手

关键词