内容
# gmail-mcp
[](https://www.npmjs.com/package/@d-mato/gmail-mcp)
用于 Gmail 的 MCP 服务器 - 通过任何 MCP 客户端搜索、阅读、归档和管理您的电子邮件。
## 设置
在您的 MCP 客户端配置中添加：
```json
{
"mcpServers": {
"gmail": {
"command": "npx",
"args": ["-y", "@d-mato/gmail-mcp"]
}
}
}
```
首次启动时，将打开一个浏览器窗口用于 Google 账户授权。授予访问权限后，令牌将存储在本地的 `~/.gmail-mcp/tokens.json` 中，您将不再需要授权。
## 可用工具
### 消息
| 工具 | 描述 |
|------|-------------|
| `gmail_search` | 使用 Gmail 查询语法搜索消息（例如 `from:user@example.com`，`is:unread`） |
| `gmail_get_message` | 按 ID 获取消息的完整内容 |
| `gmail_get_thread` | 按线程 ID 获取线程中的所有消息 |
| `gmail_archive` | 存档消息（从收件箱中移除） |
| `gmail_batch_archive` | 存档多个消息 |
| `gmail_trash` | 将消息移至垃圾箱 |
| `gmail_batch_trash` | 将多个消息移至垃圾箱 |
| `gmail_untrash` | 从垃圾箱中移除消息 |
| `gmail_mark_read` | 将消息标记为已读 |
| `gmail_mark_unread` | 将消息标记为未读 |
### 标签
| 工具 | 描述 |
|------|-------------|
| `gmail_list_labels` | 列出所有标签 |
| `gmail_add_label` | 向消息添加标签 |
| `gmail_remove_label` | 从消息中移除标签 |
| `gmail_create_label` | 创建新标签 |
| `gmail_delete_label` | 删除标签 |
## 许可证
MIT
