gmail mcp多功能
具有本机多帐户支持的Gmail MCP服务器。从单个服务器实例管理多个Gmail帐户。
与其他需要为每个帐户运行单独服务器实例的Gmail MCP不同，此MCP允许您指定在每次工具调用中使用哪个帐户，从而可以轻松地从Claude Code、Cursor或任何MCP客户端管理个人和工作收件箱。
特性
- 多账户支持 -单服务器实例，无限制的Gmail帐户
- 账户别名 -使用“工作”或“个人”等友好名称，而不是电子邮件地址
- 完整的Gmail API -搜索、阅读、发送、标记和管理电子邮件
- 批量操作 -高效地批量修改或删除电子邮件
- 自动令牌刷新 -自动处理OAuth令牌刷新
安装
npm install -g gmail-mcp-multi或者直接使用npx运行：
npx gmail-mcp-multi快速开始
1.设置谷歌云OAuth
您需要从Google Cloud Console获取OAuth凭据：
- 首选 谷歌云控制台
- 创建新项目（或使用现有项目）
- 启用Gmail API
- 创建OAuth 2.0凭据（桌面应用程序类型）
- 下载JSON凭据
2.配置MCP
创建 ~/.gmail-mcp/oauth-keys.json 使用您的OAuth凭据。
3.添加到您的MCP客户端
克劳德代码(~/.claude/settings.json):
{
"mcpServers": {
"gmail": {
"command": "npx",
"args": ["gmail-mcp-multi"]
}
}
}4.验证帐户
MCP运行后，使用 authenticate 工具：
authenticate({ alias: "work", email: "you@company.com" })
authenticate({ alias: "personal", email: "you@gmail.com" })5.使用它！
search_emails({ account: "work", query: "in:inbox is:unread" })
search_emails({ account: "personal", query: "from:mom" })工具
所有与Gmail交互的工具都需要 account 参数（别名或电子邮件）。
账户管理
| 工具 | 说明 |
|---|---|
list_accounts | 列出所有已配置的帐户和身份验证状态 |
authenticate | 添加或重新验证帐户 |
电子邮件操作
| 工具 | 说明 |
|---|---|
search_emails | 使用Gmail查询语法搜索电子邮件 |
read_email | 通过ID获取电子邮件的完整内容 |
send_email | 发送新电子邮件 |
draft_email | 创建草稿 |
modify_email | 添加/删除标签，标记已读/未读 |
delete_email | 垃圾箱或永久删除 |
batch_modify_emails | 批量标签操作 |
batch_delete_emails | 批量删除 |
标签管理
| 工具 | 说明 |
|---|---|
list_labels | 获取帐户的所有标签 |
create_label | 创建新标签 |
delete_label | 删除标签 |
配置
凭据存储在 ~/.gmail-mcp/:
~/.gmail-mcp/
├── config.json # Account aliases and settings
├── oauth-keys.json # Your Google OAuth app credentials
└── accounts/
├── work/
│ └── credentials.json
└── personal/
└── credentials.json发展
git clone https://github.com/dmorrill/gmail-mcp-multi.git
cd gmail-mcp-multi
npm install
npm run build
npm run dev贡献
欢迎投稿！请参阅 贡献.md 作为指导方针。
许可证
麻省理工学院