AI导哈

Google Workspace自动化构建器

一个帮助自动化Google Workspace任务、生成Apps Script代码并通过AI辅助构建工作流的MCP服务器。

  • by Lindsayellis22
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Lindsayellis22/google-workspace-mcp

使用说明

谷歌工作区自动化生成器MCP服务器

模型上下文协议（MCP）服务器，可帮助您自动化Google Workspace任务，生成应用程序脚本代码，并在人工智能的帮助下构建工作流。

特性

当前工具

  1. read_sheet -从谷歌表格中读取数据
  2. write_sheet -将数据写入Google表格
  3. generate.apps_script -从自然语言描述生成应用程序脚本代码
  4. create_webhook_sender -生成代码以将工作表数据发送到webhooks（Zapier、Make等）

计划的功能

  • 将Apps Script项目直接部署到Google
  • 创建和管理基于时间的触发器
  • 使用Claude生成人工智能驱动的工作流
  • 常用模式的模板库
  • 多页操作
  • 高级错误处理和日志记录

安装

  1. 克隆或导航到此目录
  2. 安装依赖项：
npm install
  1. 复制环境文件并添加您的凭据：
cp .env.example .env
  1. 构建项目：
npm run build

配置

设置Google Workspace API

  1. 首选 谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 启用Google Sheets API和Google Apps Script API
  4. 创建OAuth 2.0凭据
  5. 将凭据添加到 .env 文件

设置Anthropic API（可选）

  1. 首选 拟人控制台
  2. 生成API密钥
  3. 增添 .env 文件为 ANTHROPIC_API_KEY

与Claude Desktop一起使用

将此服务器添加到您的Claude Desktop配置中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": [
        "/Users/lindsayellis/Desktop/google-workspace-mcp/dist/index.js"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token",
        "ANTHROPIC_API_KEY": "your_anthropic_key"
      }
    }
  }
}

添加配置后，重新启动Claude Desktop。

用法示例

生成webhook发送者脚本

问克劳德：

Use the create_webhook_sender tool to generate a script that sends all data from my sheet to this Zapier webhook: https://hooks.zapier.com/hooks/catch/xxxxx/xxxxx/

生成自定义应用程序脚本

问克劳德：

Use generate_apps_script to create a script that:
- Runs every Monday at 9am
- Processes column A with AI
- Writes results to column B
- Sends a summary email

读取工作表数据

问克劳德：

Use read_sheet to get data from spreadsheet ID "1ABC...XYZ" range "Sheet1!A1:D10"

发展

在开发模式下运行并自动重新加载：

npm run dev

生产建设：

npm run build

项目结构

google-workspace-mcp/
├── src/
│   └── index.ts          # Main MCP server
├── dist/                 # Compiled JavaScript
├── .env                  # Your credentials (not committed)
├── .env.example          # Template for credentials
├── package.json
├── tsconfig.json
└── README.md

故障排除

服务器未出现在Claude Desktop中：

  1. 检查路径是否正确 claude_desktop_config.json 是正确的
  2. 确保你已经跑过了 npm run build
  3. 完全重新启动克劳德桌面
  4. 检查日志： tail -f ~/Library/Logs/Claude/mcp*.log

身份验证错误：

  1. 验证您的Google Cloud凭据
  2. 确保API已启用
  3. 检查是否配置了OAuth同意屏幕

后续步骤

  1. 设置Google OAuth身份验证
  2. 实现Claude API集成以生成脚本
  3. 添加应用程序脚本部署功能
  4. 创建模板库
  5. 添加更多高级工具

贡献

欢迎添加新工具和功能！MCP SDK使其易于扩展。

许可证

国际协调委员会

相关 MCP