Mariana Google MCP

MCPAI代理

提供方 marianasmall

AI代理 未标注 OAuth 授权 社区 / 第三方 Claude

一个安全的MCP服务器,用于通过AI管理Gmail、Google日历和Google联系人,支持多账户且所有操作都有安全限制和日志记录。

一句话选型结论

按资料字段整理

Mariana Google MCP 属于AI代理类 MCP 服务器,传输方式未标注,OAuth 授权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 20 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量20暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Google工作区TypeScript本地部署AI助手安全协议多账户管理操作日志

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 20 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 20 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mariana Google MCP当前 20 未标注 本地部署 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方marianasmall上游标注的维护方 marianasmall
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.1 KB
来自项目仓库与上游目录的原文,未做删改

玛丽安娜谷歌mcp

一个自定义的MCP(模型上下文协议)服务器,允许Claude Code访问Gmail、Google日历和Google联系人,并具有安全第一的默认设置。

设计理念

此服务器专为希望人工智能帮助管理其谷歌工作区而无意外损坏风险的运营商而构建:

  • 不发送电子邮件。 您可以起草,但发送需要在Gmail中手动操作。
  • 不删除任何内容。 Gmail使用“待删除”标签(软删除)。日历在事件标题前添加“DELETE-”。您在Google UI中查看并确认。
  • 每个突变都被记录下来。 仅追加JSONL操作日志记录了每个写入操作,包括时间戳、工具名称、帐户和摘要。
  • 多账户支持。 使用命名别名管理个人和工作帐户。

设置

1.谷歌云项目

  1. 首选 谷歌云控制台
  2. 创建新项目(或使用现有项目)
  3. 启用这些API:
    - Gmail API
    - 谷歌日历API
    - 人员API(用于联系人)
  4. 创建OAuth 2.0凭据:
    - 应用程序类型: 桌面应用
    - 下载客户端ID和客户端密码

2.安装和构建```bash

git clone https://github.com/marianasmall/mariana-google-mcp.git
cd mariana-google-mcp
npm install
npm run build


### 3.添加到克劳德代码

将此添加到您的 `~/.claude.json` 在...之下 `mcpServers`:```json
{
"mcpServers": {
"mariana-google-mcp": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mariana-google-mcp/dist/index.js"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "your-client-secret"
}
}
}
}

替换 /path/to/ 使用克隆的实际路径,并填写您的OAuth凭据。

4.身份验证

重新启动Claude Code后,运行 google_auth 工具。它将打开一个OAuth同意的浏览器窗口。一旦获得授权,您的令牌将存储在本地并自动刷新。

可用工具(19)

身份验证和状态

工具 说明
google_auth 通过OAuth浏览器流对Google帐户进行身份验证
google_status 检查所有已配置帐户的连接健康状况

Gmail(9个工具)

工具 说明
gmail_search 使用Gmail查询语法搜索邮件
gmail_read 按ID读取特定消息(完整内容)
gmail_list_labels 列出所有Gmail标签/文件夹
gmail_draft 创建电子邮件草稿(不发送)
gmail_create_label 创建新标签(支持嵌套 /)
gmail_apply_label 为一封或多封邮件应用标签
gmail_remove_label 从一封或多封邮件中删除标签
gmail_create_filter 创建筛选规则(匹配条件→ 行动)
gmail_move_to_delete 软删除:将邮件移动到“待删除”标签

日历(6工具)

工具 说明
calendar_list 列出即将到来的日历事件
calendar_search 按关键字搜索事件
calendar_get 获取特定事件的完整详细信息
calendar_create 创建事件(默认情况下不发送邀请)
calendar_update 修改现有事件(默认情况下不通知与会者)
calendar_flag_delete 软删除:在事件标题前添加“delete-”
calendar_availability 检查日期范围的忙/闲状态

联系人(2个工具)

工具 说明
contacts_search 按姓名、电子邮件或电话搜索联系人
contacts_list 列出联系人,可选择按组筛选

多账户支持

您可以使用友好名称对多个Google帐户进行身份验证:```
google_auth account_name: "primary"
google_auth account_name: "newsletters"
google_auth account_name: "work"


大多数工具都接受可选 `account` 参数。如果省略,则使用默认帐户。使用 `google_status` 查看所有已配置的帐户及其运行状况。

## 配置文件

所有配置都存储在 `~/.config/mariana-google-mcp/`:

|文件|目的|
|------|---------|
| `config.json` |帐户注册表(名称、电子邮件哈希值、默认值)|
| `tokens/.json` |每个帐户的OAuth令牌(自动刷新)|
| `actions.jsonl` |仅附加所有突变的日志|

令牌是通过电子邮件哈希而不是明文电子邮件存储的,作为间接层。

## 活动日志

每次写入操作(草稿、日历创建/更新、软删除)都会记录到 `~/.config/mariana-google-mcp/actions.jsonl` 以这种格式:```json
{"timestamp":"2026-04-03T10:30:00.000Z","tool":"gmail_draft","account":"primary","summary":"Draft created: subject='Meeting follow-up'"}

日志仅附加,服务器从不修改。随时查看以审核克劳德所做的工作。

叉和使用

要将此功能用于您自己的Google帐户:

  1. 分叉此回购
  2. 创建您自己的Google Cloud项目和OAuth凭据(请参阅上面的设置)
  3. 构建Claude代码配置并将其指向您的fork dist/index.js
  4. 跑 google_auth 鉴定

无需更改代码——所有特定于帐户的数据都存在于配置文件和环境变量中。

技术栈

  • TypeScript
  • @modelcontextprotocol/sdk --MCP协议实现
  • googleapis -Google API客户端
  • google-auth-library --OAuth2令牌管理
  • zod --输入验证

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Mariana Google MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Mariana Google MCP 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Mariana Google MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mariana Google MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Mariana Google MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Mariana Google MCP 能提供哪些能力?

资料显示约 20 个工具;能力标签包括 安全协议、TypeScript、Claude。具体工具清单以官方文档为准。

Mariana Google MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Mariana Google MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。