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 は 10 分で有効期限が切れ、成功、期限切れ、切断の後にリッスンを停止します。

ブラウザログインには、公開されている 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 は、その代替の localhost オリジンも承認されている場合にのみ設定してください。

API の送信先はツール呼び出しから受け付けられません。デフォルトでは https://control-plane.zerohrs.com で、ローカル環境やステージング環境のコントロールプレーンを使用する場合など、管理者が Codex の起動前に ZEROHRS_API_BASE_URL で設定できます。

ブラウザでのサインイン後、検証済みの ZeroHrs トークンのみが 0600 パーミッションで ~/.zerohrs/codex-mcp-session.json に保存されます。保存されたセッションは、Codex を再起動しなくてもすぐに有効になります。

disconnect を呼び出すと、保留中のブラウザログインをキャンセルして、そのローカル資格情報ファイルを削除します。/auth/logout の呼び出しやトークンの失効、他の ZeroHrs アプリセッションのサインアウトは行いません。再度呼び出しても安全です。

セッショントークンを .codex/config.toml、コミットされた .env ファイル、チャット、シェル履歴に追加しないでください。保存されたトークンは、管理者が設定した ZeroHrs API URL にのみ Authorization: Bearer <token> として送信されます。コントロールプレーンは、ミーティング、文字起こし、タスク、連絡先、準備ノート、ブリーフに対するユーザーアクセスチェックの責任を持ち続けます。

この MCP サーバーを最初に追加または更新した後は Codex を再起動し、/mcp を使用して zerohrs サーバーとそのツールが利用可能であることを確認してください。

リリース内容

このリポジトリには、スタンドアロンの公開ディストリビューションが含まれています。実行可能バンドルは dist/index.mjs で、そのランタイム依存関係は通常の npm パッケージのままです。