AI导哈

Google Workspace MCP服务器

提供Google Workspace功能（日历、邮件）的MCP服务器应用程序。

  • by Yulikepython
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 yulikepython/google-workspace-mcp-server-by-itc

使用说明

谷歌工作区MCP服务器

此项目基于以下存储库： epaproditus/googleworkspacemcp服务器

Google Workspace 的功能（日历、邮件）MCP 作为服务器提供的应用程序

机能

Gmail 机能

  • list_emails：列出最近从收件箱中筛选的邮件
  • search_emails: Gmail 使用查询语法进行高级邮件搜索
  • send_email: CC、BCC 发送支持的邮件
  • modify_email：管理邮件标签（存档、垃圾桶、已读/未读）

日历功能

  • list_events：日付范围指定付きの予定一覧表示
  • create_event：计划参与者
  • update_event：更新现有计划
  • delete_event：删除约会

必要条件

  1. Node.js: Node.js 20 安装以上
  2. Google Cloud Console 设定:
    • 谷歌云控制台访问
    • 创建新项目或选择现有项目
    • Gmail API 打开Google Calendar API 启用：
      1. "APIs & Services" > "Library"移到
      2. "Gmail API"查找并启用
      3. "Google Calendar API"查找并启用
    • OAuth 2.0 设置凭据：
      1. "APIs & Services" > "Credentials"移到
      2. "Create Credentials" > "OAuth client ID"来修改标记元素的显示属性
      3. "Desktop application"列表框中，此格式对应于条目“无”
      4. "Authorized redirect URIs"在…之上http://localhost:4100/code添加
      5. Client ID 打开Client Secret 记录

安装过程

  1. 克隆和安装存储库:

    git clone https://github.com/Yulikepython/gogole-workspace-mcp-server-by-itc.git
cd google-workspace-mcp-server-by-itc
npm install

  2. 设置凭据:

    # credentials.json.exampleをコピー
cp credentials.json.example credentials.json

    credentials.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"
  }
}

  3. 获取刷新标记:

    node get-refresh-token.js

    因此：

    • 打开浏览器Google OAuth 执行验证
    • 请求以下权限：
      • https://www.googleapis.com/auth/gmail.modify
      • https://www.googleapis.com/auth/calendar
      • https://www.googleapis.com/auth/gmail.send
    • 认证信息token.json将条目添加到文档注册表
    • 在控制台中显示刷新标记

  4. MCP 配置配置配置: MCP 将服务器设置添加到配置文件：

    • VSCode Claude 扩张机能： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
    • Claude 桌面应用程序： ~/Library/Application Support/Claude/claude_desktop_config.json

    mcpServers向对象添加：

    {
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/path/to/google-workspace-server/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

  5. 构建和运行:

    npm run build

  6. 添加部署设置（.env）:

    deploy 使用脚本 .env 需要文件。

    cp .env.example .env

    .env 请在中设置以下环境变量：

    SSH_USER=your_ssh_user
SSH_HOST=your.ssh.host
SSH_PATH=/your/deploy/path

npm脚本

｜命令｜说明｜ |----------------|-------------------------------------| | npm run build｜创建包并授予可执行权限｜ | npm run start在本地构建和运行 | npm run clean删除构建交付件 | npm run deploy构建后，将文件部署到生产环境中 | npm run logs 实时查看生产环境中的应用程序日志

使用例

Gmail 操作

  1. 最近的邮件一览:

    {
  "maxResults": 5,
  "query": "is:unread"
}

  2. 邮件搜索:

    {
  "query": "from:example@gmail.com has:attachment",
  "maxResults": 10
}

  3. 发送邮件:

    {
  "to": "recipient@example.com",
  "subject": "Hello",
  "body": "Message content",
  "cc": "cc@example.com",
  "bcc": "bcc@example.com"
}

  4. 更改邮件标签:

    {
  "id": "message_id",
  "addLabels": ["UNREAD"],
  "removeLabels": ["INBOX"]
}

日历操作

  1. 予定一覧:

    {
  "maxResults": 10,
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z"
}

  2. 予定作成:

    {
  "summary": "Team Meeting",
  "location": "Conference Room",
  "description": "Weekly sync-up",
  "start": "2024-01-24T10:00:00Z",
  "end": "2024-01-24T11:00:00Z",
  "attendees": ["colleague@example.com"]
}

  3. 予定更新:

    {
  "eventId": "event_id",
  "summary": "Updated Meeting Title",
  "location": "Virtual",
  "start": "2024-01-24T11:00:00Z",
  "end": "2024-01-24T12:00:00Z"
}

  4. 予定削除:

    {
  "eventId": "event_id"
}

故障排除

  1. 认证问题:

    • 必需的OAuth 确认是否已授予作用域
    • Client ID 打开Secret 确认是否正确
    • 确认刷新标记是否有效

  2. API 错误:

    • Google Cloud Console 单击功能区上API 检查配额和限制
    • 在项目中API 已启用
    • 确认请求参数的格式是否正确

许可证

麻省理工学院

相关 MCP