local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows searching and retrieving emails from a Gmail account, with capabilities to search for specific emails, retrieve full email content, and list recent messages from the inbox.
Uses Google Cloud Console for API credentials and OAuth authentication to enable Gmail access.

Gmail 多账户管理平台

允许 Claude 从您的 Gmail 帐户搜索和检索电子邮件。

设置

1.获取 Google API 凭证

访问Google Cloud Console
创建新项目或选择现有项目
为您的项目启用 Gmail API
- 导航至“API 和服务”>“库”
- 搜索“Gmail API”并启用它
创建 OAuth 凭证：
- 前往“API 和服务”>“凭证”
- 点击“创建凭证”>“OAuth 客户端 ID”
- 选择“桌面应用程序”作为应用程序类型
- 为您的客户命名并点击“创建”
下载凭证 JSON 文件
将其保存为项目目录中的credentials.json

2.授权应用程序

运行授权命令来生成您的令牌：

uv run gmail-mcp auth --creds-path credentials.json --token-path token.json

这将打开一个浏览器窗口，您需要在其中登录您的 Google 帐户并授予必要的权限。授权后，将在您的项目目录中创建一个token.json文件。

使用 Claude 进行配置

将 Gmail MCP 服务器添加到您的 Claude 配置文件中：

{
  "mcpServers": {
    "gmail": {
      "args": [
        "--from",
        "git+https://github.com/vinayak-mehta/gmail-mcp",
        "gmail-mcp"
      ],
      "command": "/Users/username/.local/bin/uvx",
      "env": {
        "GMAIL_CREDS_PATH": "/Users/username/path/to/gmail-mcp/credentials.json",
        "GMAIL_TOKEN_PATH": "/Users/username/path/to/gmail-mcp/token.json"
      }
    }
  }
}

请确保：

将/Users/username/path/to/gmail-mcp替换为您的实际项目路径
调整已安装的uvx可执行文件的command路径
提供credentials.json和token.json文件的正确路径

克劳德现在可以使用以下工具：

1. 搜索电子邮件

在您的 Gmail 帐户中搜索电子邮件。

示例提示： “搜索来自example@gmail.com的所有电子邮件”

2. 获取电子邮件内容

检索特定电子邮件的完整内容。

提示示例： “显示主题为‘明天开会’的电子邮件的完整内容”

3. 列出消息

列出您的 Gmail 收件箱中的最新消息。

提示示例： “列出我最近的 5 封电子邮件”

环境变量

您可以使用环境变量配置凭证和令牌文件的路径：

GMAIL_CREDS_PATH ：您的 credentials.json 文件的路径
GMAIL_TOKEN_PATH ：token.json 文件的路径

使用这些变量在项目根目录中创建一个.env文件，以便于配置。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

允许 Claude 从您的 Gmail 帐户搜索和检索电子邮件的服务器，支持搜索电子邮件、检索特定电子邮件的完整内容以及列出最近消息等功能。

Related Resources

Reddit Discussion about this server