Google Workspace集成服务

Auralis Google是一个将Claude AI与Google Workspace服务(如Gmail、日历、Drive、Docs和Sheets)无缝集成的MCP服务器。

  • by antonpme
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 antonpme/auralis-google

使用说明

Auralis谷歌

用于Google Workspace与Claude AI集成的MCP服务器

Auralis Google通过模型上下文协议(MCP)在Claude AI和Google Workspace服务之间提供无缝集成。直接从Claude访问Gmail、日历、驱动器、文档和表格。

特性

  • Gmail:搜索邮件、阅读电子邮件、发送电子邮件、管理标签
  • 日历:列出事件、创建/更新/删除事件、列出日历
  • 驾驶:列出文件、搜索、读取内容、创建/删除文件和文件夹
  • 文档:读取文档、附加文本、创建新文档
  • 表格:完整的电子表格管理-读取、写入、追加、删除行、管理工作表

安装

选项1:npm(推荐)

npm install -g auralis-google

选项2:Docker

docker pull antonpme/auralis-google
docker run -p 3000:3000 \
  -e GOOGLE_CLIENT_ID=your_client_id \
  -e GOOGLE_CLIENT_SECRET=your_client_secret \
  -e GOOGLE_REDIRECT_URI=http://localhost:3000/oauth/callback \
  antonpme/auralis-google

选项3:克隆和构建

git clone https://github.com/antonpme/auralis-google.git
cd auralis-google
npm install
npm run build

谷歌云设置

在使用Auralis Google之前,您需要创建OAuth凭据:

  1. 首选 谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 启用以下API:
    • Gmail API
    • 谷歌日历API
    • Google Drive API
    • 谷歌文档API
    • 谷歌网页API
  4. 首选 凭证 → 创建凭证 → OAuth客户端ID
  5. 选择 Web应用程序
  6. 添加授权重定向URI: http://localhost:3000/oauth/callback
  7. 复制 客户端ID 和 客户端密钥

配置

克劳德桌面(stdio模式)

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "google": {
      "command": "auralis-google",
      "env": {
        "MCP_MODE": "stdio",
        "GOOGLE_CLIENT_ID": "your_client_id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth/callback"
      }
    }
  }
}

HTTP模式(铁路/Docker)

设置这些环境变量:

变量 描述
PORT 服务器端口(默认值:3000)
MCP_MODE 设置为 http 用于HTTP模式(默认)
GOOGLE_CLIENT_ID OAuth客户端ID
GOOGLE_CLIENT_SECRET OAuth客户端密码
GOOGLE_REDIRECT_URI OAuth回调URL
TOKENS_PATH 存储令牌的路径(默认值: ./data/tokens.json)

HTTP端点:

端点 方法 描述
/mcp POST MCP协议端点(可流式HTTP)
/auth?account=xxx GET 启动帐户的OAuth流
/oauth/callback GET OAuth回调处理程序
/health GET 健康检查

认证

首次使用时,您需要向Google进行身份验证:

HTTP模式:

  1. 打开 http://localhost:3000/auth?account=personal 浏览器中
  2. 使用您的Google帐户登录
  3. 授予权限
  4. 你会看到“✅ 身份验证为your@email.com"

标准模式: 您需要先在HTTP模式下运行服务器以完成OAuth,然后切换到stdio。

多个帐户

您可以验证多个Google帐户:

/auth?account=personal
/auth?account=work
/auth?account=client

然后在使用工具时指定帐户:

{
  "account": "work",
  "query": "is:unread"
}

工具参考

账户管理

工具 说明
google_list_accounts 列出所有经过身份验证的Google帐户

Gmail(4个工具)

工具 说明
google_gmail_search 使用查询搜索Gmail邮件
google_gmail_read 按ID阅读特定电子邮件
google_gmail_send 发送电子邮件
google_gmail_labels 列出Gmail标签

日历(5个工具)

工具 说明
google_calendar_list 列出所有日历
google_calendar_list_events 使用可选时间过滤器列出事件
google_calendar_create_event 创建新事件
google_calendar_update_event 更新现有事件
google_calendar_delete_event 删除事件

驱动器(8个工具)

工具 说明
google_drive_list 列出驱动器或文件夹中的文件
google_drive_search 按内容搜索文件
google_drive_get 获取文件元数据
google_drive_read 读取文件内容(文本/Google文档)
google_drive_create 创建新文件
google_drive_delete 删除文件
google_drive_create_folder 创建文件夹
google_drive_move 将文件移动到另一个文件夹

文档(3个工具)

工具 说明
google_docs_read 阅读谷歌文档
google_docs_append 在文档中添加文本
google_docs_create 创建新的Google文档

表格(10个工具)

工具 说明
google_sheets_create 创建新的电子表格
google_sheets_read 从范围读取数据
google_sheets_append 将行附加到工作表
google_sheets_update 更新范围内的单元格
google_sheets_info 获取电子表格元数据
google_sheets_delete_rows 删除行
google_sheets_clear 清除范围内的单元格
google_sheets_add_sheet 添加新图纸选项卡
google_sheets_delete_sheet 删除图纸选项卡
google_sheets_rename_sheet 重命名图纸选项卡

用法示例

搜索未读电子邮件

Search my Gmail for unread messages from last week

创建日历事件

Create a meeting called "Project Review" tomorrow at 3pm for 1 hour

读取电子表格数据

Read all data from my Budget spreadsheet

发送邮件

Send an email to john@example.com with subject "Meeting Notes" and the summary of our discussion

与Google Workspace CLI的比较

谷歌发布了 谷歌工作区CLI (gws)2026年3月,一个基于Rust的CLI+MCP服务器,可以动态发现所有Google API。这是一个令人印象深刻的项目。以下是它的比较:

概览

Auralis谷歌 谷歌工作区CLI
聚焦 生产MCP服务器 CLI工具+MCP服务器
成熟 稳定,生产测试 v1.0之前,快速迭代
语言 TypeScript(可破解) Rust(二进制,不可修改)
运输 HTTP流媒体+标准 仅限标准
远程部署 ✅ 铁路、Docker、任何云❌ 仅限本地
谷歌服务 5(Gmail、日历、驱动器、文档、表格) 26+(自动发现)
MCP工具 31(聚焦) 200-400全/~26紧凑型
多账户 ✅ 稳定 ⚠️ 记录在案的身份验证问题
自定义OAuth应用程序 ✅ 您自己的GCP项目 ✅ 您自己的GCP项目
范围控制 5个范围,始终在限制范围内 85+推荐,达到未经验证的应用上限
谷歌官方产品 否 否(“未得到官方支持”)

为什么选择Auralis谷歌

1.远程优先架构

Auralis Google在Railway、Docker或任何云提供商上运行。你的人工智能助手可以从任何地方访问谷歌API,而不仅仅是你的本地机器。 gws MCP模式仅在stdio(本地进程)上工作。

2.生产稳定

跨多个帐户的真实使用情况。没有身份验证循环,没有令牌刷新问题,没有范围冲突。 gws 正在积极开发中 开放式身份验证相关问题.

3.刀具表面尺寸合适

31个专门构建的工具,涵盖了谷歌工作区的核心工作流程。你的AI不会燃烧加载200多个工具定义的上下文令牌。每个工具都有明确的输入模式和Zod验证。

4.可被黑客攻击

你可以阅读、修改和扩展TypeScript源代码。需要定制工具吗?将其添加到20行中。Rust二进制文件不提供这种灵活性。

什么时候考虑gws

  • 您需要核心5之外的谷歌服务(幻灯片、表单、任务、会议、聊天、保留、管理员)
  • 您希望CLI访问Google API(而不仅仅是MCP)
  • 您更喜欢一个工具来处理所有事情,不需要远程部署
  • 您对v1.0之前的软件很熟悉,可以解决身份验证问题

摘要

场景 建议
用于AI助手的生产MCP服务器 Auralis谷歌
用于快速调用Google API的本地CLI gws
需要幻灯片、表格、任务或会议 gws (或添加到Auralis谷歌)
多机/云部署 Auralis谷歌
想要修改或扩展代码 Auralis谷歌

我们的看法: 使用Auralis Google进行生产AI工作流程。留意 gws 随着它的成熟,它可能会成为核心5之外服务的有力补充。

铁路部署

  1. 分叉此存储库
  2. 连接到铁路
  3. 在铁路仪表板中设置环境变量
  4. 部署

或者使用此仓库中包含的railway.json。

建筑

auralis-google/
├── src/
│   ├── index.ts      # MCP server + Express endpoints
│   ├── auth.ts       # OAuth2 management
│   └── tools/
│       ├── gmail.ts
│       ├── calendar.ts
│       ├── drive.ts
│       ├── docs.ts
│       └── sheets.ts
├── dist/             # Compiled JavaScript
├── data/             # Token storage (gitignored)
├── Dockerfile
├── railway.json
└── package.json

安全

  • OAuth令牌存储在本地 ./data/tokens.json
  • 令牌过期时会自动刷新
  • 永远不要承诺你的 data/ 文件夹或 .env 文件
  • 使用环境变量作为凭据

贡献

欢迎投稿!请打开问题或提交拉取请求。

许可证

MIT许可证-请参阅 许可证 文件。

链接