Auralis Google

Auralis谷歌

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

](https://www.npmjs.com/package/auralis-google)


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

1. 首选 凭证 → 创建凭证 → OAuth客户端ID
2. 选择 Web应用程序
3. 添加授权重定向URI： http://localhost:3000/oauth/callback
4. 复制 客户端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）

设置这些环境变量：

HTTP端点：

认证

首次使用时，您需要向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"
}

工具参考

账户管理

Gmail（4个工具）

日历（5个工具）

驱动器（8个工具）

文档（3个工具）

表格（10个工具）

用法示例

搜索未读电子邮件

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谷歌

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之前的软件很熟悉，可以解决身份验证问题

摘要

我们的看法： 使用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许可证-请参阅 许可证 文件。

链接

• 奥拉利斯指挥官 -Windows MCP服务器