ZeroHrs MCP 服务器

此公共本地 MCP 服务器将已登录用户的 ZeroHrs 数据提供給 Codex。它使用 ZeroHrs API 及其用户授权检查。

如需一份可共享、面向智能体的安装指南，请参阅 INSTALL.md。

安装到 Codex

需要 Node.js 20 或更高版本。先检查任何现有的 zerohrs 条目，然后再替换它，最后安装公开的已标记版本：

codex mcp add zerohrs -- npx -y github:ZeroHrs-Org/zerohrs-mcp#v0.2.0

在 ~/.codex/config.toml 中为此服务器设置 default_tools_approval_mode = "writes"，重启 Codex，然后不带参数调用 login 工具。

Related MCP server: vibelogin-mcp

工具

只读工具：

• search_zero

• list_meetings

• list_transcripts

• search_transcripts

• get_transcript

• list_tasks

• get_task

• get_meeting_prep

写入工具，Codex 会请求批准：

• login

• disconnect

• create_task

• update_task

• add_meeting_prep_note

该服务器故意不提供发送电子邮件或消息、安排会议机器人、分享转录、删除数据或在外部服务中执行操作的工具。

get_transcript 默认返回转录摘要。它可以包含关联的任务和查询匹配的发言人块，但默认不会加载每个转录轮次。

登录与退出

该服务器通过 STDIO 在本地运行。启动时不需要会话令牌。

不带参数调用 login。它会返回一个可点击的、短时有效的 URL，地址为：

• http://localhost:3100

打开该 URL 并选择 Sign in with Google。官方的 Google 登录会在你的系统浏览器中打开，而不是在 Codex 内嵌浏览器中。本地 MCP 用 Google 凭据与 ZeroHrs 交换，并通过 /auth/profile 检查返回的会话。任何 Google 凭据或 ZeroHrs 会话令牌都不会经过 Codex 聊天。该 URL 在十分钟后过期，并且在成功、过期或断开后会停止监听。

浏览器登录使用的是公共 ZeroHrs 生产环境的 Google 用户端 ID。管理员可以用 ZEROHRS_GOOGLE_WEB_CLIENT_ID 或 GOOGLE_WEB_CLIENT_ID 将为零。对于仓库开发，它还可以从 backend/control-plane/.env 读取 GOOGLE_WEB_CLIENT_ID。Google Web 客户端必须把 http://localhost:3100 设置为 JavaScript 来源。只有当该授权过的本地主机端口也被授权时，才设置 ZEROHRS_MCP_LOGIN_PORT。

API 地址不被接受在工具调用中設定。它默认为 https://example.com 或由管理员在 Codex 启动前通过 ZEROHRS_API_BASE_URL 设置，例如使用本地或staging 控制平面时.

符号访问后，只有已证实的 ZeroHrs 令牌会在 ~/.zerohrs/codex-mcp-session.json 中以 0600 权限保存。此会话无需重启 Codex 即可立即生效。

调用 disconnect 可以取消任何待定得浏览器登录并删除本地凭据文件。它不会调用 /auth/logout 撤销令牌，也不会退出其他 ZeroHrs 应用会话。重复调用是安全的。

请勿将会话令牌添加到 .codex/config.toml、提交到 .env 文件、聊天或 shell 历史中。保存的令牌仅作为 Authorization: Bearer <token> 发送到管理员配置的 ZeroHrs API URL。控制平面仍负责对会议、转录、任务、联系人、准备笔记和摘要进行用户权限检查。

最初添加或更新此 MCP 服务器后，请重启 Codex，然后使用 /mcp 确认 zerohrs 服务器及其工具是否可用。

发布内容

本仓库包含有独立的公共发行版。可执行包是 dist/index.mjs；其运行时依赖仍保持为常规 npm 包。