快速入门

前置条件

• 安装 Python 3.12 或更高版本
• 启用 Google Cloud 项目中的 Gmail API 并生成 OAuth 凭据

安装步骤

1. 克隆仓库： git clone cd gmail-mcp-server
2. 创建虚拟环境并激活： python -m venv venv

   Windows 用户运行：venv\Scripts\activate

   Unix/MacOS 用户运行：source venv/bin/activate

3. 安装依赖：pip install .

配置步骤

1. 在 Google Cloud Console 中启用 Gmail API，并下载 OAuth 客户端凭据。
2. 将下载的凭据文件重命名为 client_secret.json 并放置在项目根目录。
3. 编辑 gmail_token_creator.py 配置邮箱标识符，然后运行以下命令以完成身份验证： python gmail_token_creator.py

启动服务

运行以下命令启动服务器： python gmail_server.py

使用示例

发送邮件

await send_gmail( email_identifier="your.email@gmail.com", to="recipient@example.com", subject="测试主题", body="邮件正文内容" )

搜索邮件

await search_email_tool( email_identifier="your.email@gmail.com", query="from:someone@example.com" )

查看最新邮件

await read_latest_emails( email_identifier="your.email@gmail.com", max_results=5 )

更多功能详见 README 文档。