增强型 Gmail MCP 服务器

增强型 Gmail MCP 服务器

一个功能强大的 Gmail 集成 MCP 服务器，支持通过自然语言管理电子邮件。

GitHub
Created Bytheposchtheposch

快速入门

前置条件

  • Python 3.8+
  • 启用 Gmail API 的 Google Cloud 项目
  • OAuth 2.0 凭据

安装

克隆仓库并设置虚拟环境：

git clone https://github.com/theposch/gmail-mcp.git
cd gmail-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .

配置 Google Cloud

  1. 创建 Google Cloud 项目。
  2. 启用 Gmail API。
  3. 配置 OAuth 同意屏幕。
  4. 下载 OAuth 2.0 凭据文件。

存储凭据文件并运行服务器：

mkdir -p ~/.gmail-mcp
mv ~/Downloads/client_secret_*.json ~/.gmail-mcp/credentials.json

使用

运行以下命令测试：

npx @modelcontextprotocol/inspector uv run /path/to/gmail-mcp/src/gmail/server.py --creds-file-path /path/to/credentials.json --token-path /path/to/tokens.json