MCP G Suite Integration

mcp-gsuite mcp服务器

](https://smithery.ai/server/@alBERT-launcher/mcp-gsuite) MCP服务器与谷歌产品交互。

示例提示

目前，此MCP服务器支持Gmail和日历集成，具有以下功能：

1. 将军

• 多个谷歌账户

1. Gmail

• 获取您的Gmail用户信息
• 通过灵活搜索查询电子邮件（例如，未读、来自特定发件人、日期范围、带附件）
• 按ID检索完整的电子邮件内容
• 创建包含收件人、主题、正文和抄送选项的新电子邮件草稿
• 删除电子邮件草稿
• 回复现有电子邮件（可以立即发送或另存为草稿）
• 通过ID一次检索多封电子邮件。
• 将电子邮件中的多个附件保存到本地系统。

1. 日历

• 管理多个日历
• 获取指定时间范围内的日历事件
• 使用以下工具创建日历事件：

- 标题、开始/结束时间 - 可选位置和描述 - 可选与会者 - 自定义时区支持 - 通知首选项

• 删除日历事件

您可以尝试的示例提示：

• 检索我最近未读的邮件

• 搜索我的Scrum Master电子邮件

• 从会计处检索所有电子邮件

• 接收关于ABC的电子邮件并对其进行总结

• 给爱丽丝的最后一封电子邮件写一个漂亮的回复，并上传一份草稿。

• 用感谢信回复Bob的电子邮件。将其存储为草稿

• 我明天的日程安排是什么？

• 查看我的私人账户下周的家庭日程

• 我需要和蒂姆计划下周两个小时的活动。建议一些时间段。

快速启动

安装

通过Smithery安装

通过以下方式自动安装G Suite Integration for Claude Desktop 史密瑟里:

npx -y @smithery/cli install @alBERT-launcher/mcp-gsuite --client claude

Oauth 2

Google Workspace（G Suite）API需要OAuth2授权。按照以下步骤设置身份验证：

1. 创建OAuth2凭据：

- 转到 谷歌云控制台 - 创建新项目或选择现有项目 - 为您的项目启用Gmail API和Google Calendar API - 转到“凭据”→ “创建凭据”→ “OAuth客户端ID” - 选择“桌面应用程序”或“Web应用程序”作为应用程序类型 - 使用所需信息配置OAuth同意屏幕 - 添加授权重定向URI（包括 http://localhost:4100/code 地方发展）

1. 所需OAuth2范围：

   [
     "openid",
     "https://mail.google.com/",
     "https://www.googleapis.com/auth/calendar",
     "https://www.googleapis.com/auth/userinfo.email"
   ]

1. 然后创建一个 .gauth.json 在客户端的工作目录中

{
    "web": {
        "client_id": "$your_client_id",
        "client_secret": "$your_client_secret",
        "redirect_uris": ["http://localhost:4100/code"],
        "auth_uri": "https://accounts.google.com/o/oauth2/auth",
        "token_uri": "https://oauth2.googleapis.com/token"
    }
}

1. 创建一个 .accounts.json 包含帐户信息的文件

{
    "accounts": [
        {
            "email": "alice@bob.com",
            "account_type": "personal",
            "extra_info": "Additional info that you want to tell Claude: E.g. 'Contains Family Calendar'"
        }
    ]
}

您可以指定多个帐户。确保他们可以访问您的Google Auth应用程序。这 extra_info 字段特别有趣，因为您可以在此处添加您想告诉AI有关帐户的信息（例如，它是否有特定的议程）

注意：当您首次为特定帐户执行其中一个工具时，浏览器将打开，将您重定向到谷歌，并询问您的凭据、范围等。成功登录后，它将凭据存储在名为的本地文件中 .oauth.{email}.json 。一旦您获得授权，将使用刷新令牌。

克劳德桌面

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json

在Windows上： %APPDATA%/Claude/claude_desktop_config.json

Development/Unpublished Servers Configuration

{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uv",
      "args": [
        "--directory",
        "/mcp-gsuite",
        "run",
        "mcp-gsuite"
      ]
    }
  }
}

Published Servers Configuration

{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uvx",
      "args": [
        "mcp-gsuite"
      ]
    }
  }
}

配置选项

MCP服务器可以配置几个命令行选项，以指定身份验证和帐户信息的自定义路径：

• --gauth-file：指定到的路径 .gauth.json 包含OAuth2客户端配置的文件。默认值为 ./.gauth.json.
• --accounts-file：指定到的路径 .accounts.json 包含有关Google帐户信息的文件。默认值为 ./.accounts.json.
• --credentials-dir：指定成功身份验证后存储OAuth凭据的目录。默认值是当前工作目录，每个帐户都有一个子目录，如下所示 .oauth.{email}.json.

这些选项允许灵活管理不同的环境或多组凭据和帐户，在开发和测试场景中特别有用。

示例用法：

uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials

当您有多个服务器实例以不同的配置运行，或者部署到默认路径不合适的环境时，此配置特别有用。

发展

建筑与出版

准备分发包裹：

1. 同步依赖关系并更新锁文件：

uv sync

1. 构建包分发：

uv build

这将在 dist/ 目录。

1. 发布到PyPI：

uv publish

注意：您需要通过环境变量或命令标志设置PyPI凭据：

• 令牌： --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码： --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.

您可以通过以下方式启动MCP检查器 使用此命令：

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。

您还可以使用以下命令查看服务器日志：

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log