Gmail MCP Server

基本能力

产品定位

Gmail MCP Server 是一个用于集成 Gmail API 的服务，旨在为 AI 助手提供与 Gmail 和日历服务交互的能力。

核心功能

• 邮件操作
• 列出带有高级过滤的邮件
• 读取特定邮件的完整内容
• 创建和发送新邮件
• 草稿管理
• 创建新草稿
• 列出现有草稿
• 读取草稿内容
• 更新草稿内容和收件人
• 删除草稿
• 日历操作
• 列出即将到来的日历事件
• 读取详细的事件信息
• 创建新日历事件
• 事件过滤和搜索
• 时区支持
• iOS 日历同步支持

适用场景

• AI 助手与 Gmail 和日历服务的集成
• 自动化邮件处理和草稿管理
• 日历事件的自动化管理

工具列表

• 邮件工具：用于邮件操作和搜索
• 草稿工具：用于草稿的创建、读取、更新和删除
• 日历工具：用于日历事件的管理和搜索

常见问题解答

• 认证失败
• API 速率限制
• 无效请求
• 网络问题
• 日历同步问题
• 事件 ID 验证
• 时区验证

使用教程

使用依赖

• Node.js (v14 或更高版本)
• npm (v6 或更高版本)
• Google Cloud Platform 账户，已启用 Gmail 和 Calendar API
• 具有适当范围的 OAuth 2.0 凭证

安装教程

1. 克隆并安装依赖： bash git clone [repository-url] cd gmail-mcp-server npm install

2. 配置环境： ```bash # 创建 .env 文件 cp .env.example .env

# 添加您的凭证： GOOGLE_CLIENT_ID="your_client_id" GOOGLE_CLIENT_SECRET="your_client_secret" REDIRECT_URI="http://localhost:4100/code" GOOGLE_REFRESH_TOKEN="your_refresh_token" ```

1. 构建并运行： bash npm run build npm start

调试方式

• 使用 npm run dev 构建并运行监视模式
• 使用 npm run build 构建项目
• 使用 npm run clean 清理构建产物
• 使用 npm run watch 监视更改

许可证

该项目遵循 MIT 开源许可条款。