Google Drive MCP (google-drive-mcp)

Google Drive MCP 服务器

通过模型上下文协议（MCP），赋予Claude管理您Google Drive文件的能力。

可用工具

一旦配置完成，Claude可以：

• 创建驱动器文件夹 - 在你的云端硬盘中创建新文件夹
• 移动驱动文件 - 在不同位置之间移动文件/文件夹
• 重命名驱动器文件 - 重命名任何文件或文件夹
• 获取驱动器文件信息 - 获取文件的元数据
• 列出驱动器文件夹内容 - 查看文件夹中的内容

示例用法

“在云端硬盘中创建文件夹结构，以便整理：个人、工作和项目” “将所有名称中包含‘会议记录’的文件移动到工作文件夹” “向我展示我的根驱动器文件夹里的内容”

设置

先决条件

• Python 3.10+（或 Python 3.10及以上版本）
• 谷歌账户
• Claude 桌面应用程序

1. Google 云服务设置

1. 首选 Google Cloud 控制台
2. 创建一个新项目或选择一个现有项目
3. 启用 谷歌云端硬盘API
4. 创建 OAuth 2.0 凭据：

- 进入“APIs和服务”→“凭据” - 点击“创建凭据”→“OAuth 客户端 ID” - 选择“桌面应用” - 下载JSON文件

可能需要在“OAuth 同意屏幕”选项卡下将自己添加为测试用户。

2. 安装依赖项

# Clone this repository
git clone https://github.com/danbugs/google-drive-mcp.git
cd google-drive-mcp

# Create virtual environment
python -m venv venv

# Activate virtual environment
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

3. 设置凭据

# Create credentials directory
mkdir ~/.google-drive-mcp  # or %USERPROFILE%\.google-drive-mcp on Windows

# Move your downloaded credentials file
# Rename it to credentials.json and place in ~/.google-drive-mcp/

4. 测试认证

运行测试脚本以完成OAuth设置：

python test_auth.py

这将打开一个浏览器窗口用于Google认证，并创建所需的（内容/设置） token.json 文件。

5. 配置Claude桌面版

编辑您的Claude桌面配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\ Windows： %APPDATA%\Claude\claude_desktop_config.json\ Linux： ~/.config/Claude/claude_desktop_config.json

添加MCP服务器配置：

{
  "mcpServers": {
    "google-drive": {
      "command": "/path/to/your/venv/bin/python",
      "args": ["/path/to/your/google_drive_mcp_server.py"]
    }
  }
}

替换 /path/to/your/ 使用你实际的路径。在Windows上，请使用 venv\Scripts\python.exe 相反。

6. 重启Claude桌面版

退出并重新启动 Claude Desktop，然后进行测试：

“你能列出我Google Drive根文件夹的内容吗？”

安全

• OAuth 凭据本地存储在 ~/.google-drive-mcp/
• 仅可通过MCP通过Claude Desktop访问
• 标准的Google OAuth安全模型
• 随时在Google帐户设置中撤销访问权限

故障排除

“凭证文件未找到”

• 确保 credentials.json 在（某处/某状态/某范围内） ~/.google-drive-mcp/
• 检查文件权限

“模块未找到”错误

• 激活虚拟环境
• 重新运行 pip install -r requirements.txt

克劳德看不到工具

• 验证 claude_desktop_config.json 语法是有效的JSON
• 使用绝对路径，而非相对路径
• 完全重启Claude桌面版
• 检查Claude Desktop日志：帮助 → “显示日志”

认证问题

• 删除 ~/.google-drive-mcp/token.json 并重新运行 test_auth.py
• 确保在云端控制台中已启用 Google Drive API

资源

• 谷歌云端硬盘API文档
• MCP 文档