Google Toolbox

🚀 py-mcp-google

py-mcp-google 是一款 MCP 服务器工具，它为用户与 Google Workspace（涵盖 Gmail、Google Calendar 和 Google Drive）的交互提供了便捷的接口，让用户能更高效地使用 Google 的各项服务。

🚀 快速开始

运行后，你可以通过访问 http://localhost:8000 使用 Web 界面。

✨ 主要特性

• 为与 Google Workspace（包括 Gmail、Google Calendar 和 Google Drive）交互提供接口。
• 提供多种工具，如 Gmail 工具、日历工具、Drive 工具和搜索工具，满足不同的使用需求。

📦 安装指南

从源码安装

1. 克隆仓库：

git clone git@github.com:jikime/py-mcp-google.git
cd py-mcp-google
pip install .

2. 启动服务器：

uv run server.py

使用 Docker

docker build -t py-mcp-google .
docker run -it py-mcp-google

💻 使用示例

客户端示例

# 列出邮件
uv run client.py list_emails max_results=5 query="is:unread"

# 搜索邮件
uv run client.py search_emails query="from:test@example.com"

# 发送邮件
uv run client.py send_email to="test@example.com" subject="测试邮件" body="你好"

# 修改邮件
uv run client.py modify_email id=MESSAGE_ID remove_labels=INBOX add_labels=ARCHIVED

# 列出活动
uv run client.py list_events time_min=2025-05-01T00:00:00+09:00 time_max=2025-05-02T23:59:59+09:00 max_results=5

# 创建活动
uv run client.py create_event summary="新事件" start=2025-05-02T10:00:00+09:00 end=2025-05-02T11:00:00+09:00

# 更新活动
uv run client.py update_event id=event_id summary="更新后的事件" start=2025-05-03T10:00:00+09:00

# 删除活动
uv run client.py delete_event id=event_id

# 读取文件
uv run client.py read_gdrive_file id=file_id

# 搜索文件
uv run client.py search_gdrive query="test"

📚 详细文档

配置

环境变量

设置以下环境变量以自定义行为：

• GOOGLE_CREDENTIALS: Google API 凭证文件路径
• DEFAULT_EMAIL: 默认电子邮件地址

工具文档

Gmail 工具

• list_emails: 列出收件箱中的近期邮件，支持过滤选项。
• search_emails: 执行高级搜索并获取详细邮件内容。
• send_email: 编写并发送邮件，支持 CC 和 BCC 收件人。
• modify_email: 修改邮件状态（已读/未读、存档、删除）。

日历工具

• list_events: 获取指定时间段内的日历活动。
• create_event: 创建新事件，支持添加参与者和位置描述。
• update_event: 更新现有事件信息。
• delete_event: 根据活动 ID 删除事件。

Drive 工具

• read_gdrive_file: 读取并获取 Google Drive 文件内容。
• search_gdrive: 搜索文件，支持自定义查询。

搜索工具

• search_google: 执行 Google 搜索并返回格式化结果。

配置示例

Claude desktop app

在 app.json 中添加：

{
  "py-mcp-google": {
    "url": "http://localhost:8000",
    "email": "你的电子邮件地址"
  }
}

Cursor IDE

在项目根目录创建 mcp-config.json：

{
  "google": {
    "credentials": "~/.config/google/creds.json",
    "defaultEmail": "你@example.com"
  }
}

📄 许可证

本项目采用 MIT 许可证。