ZeroHrs MCP server

Dieser öffentliche lokale MCP-Server stellt die ZeroHrs-Daten des angemeldeten Benutzers für Codex bereit. Er verwendet die ZeroHrs-API und deren Benutzerautorisierungsprüfungen.

Für eine teilbare, agentenorientierte Installationsanleitung siehe INSTALL.md.

Installation in Codex

Erforderlich ist Node.js 20 oder neuer. Prüfen Sie einen eventuell vorhandenen zerohrs-Eintrag, bevor Sie ihn ersetzen, und installieren Sie dann das öffentliche, getaggte Release:

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

Setzen Sie default_tools_approval_mode = "writes" für diesen Server in ~/.codex/config.toml, starten Sie Codex neu und rufen Sie das Tool login ohne Argumente auf.

Related MCP server: vibelogin-mcp

Werkzeuge

Nur-Lese-Werkzeuge:

• search_zero

• list_meetings

• list_transcripts

• search_transcripts

• get_transcript

• list_tasks

• get_task

• get_meeting_prep

Schreib-Werkzeuge, für die Codex um Genehmigung bittet:

• login

• disconnect

• create_task

• update_task

• add_meeting_prep_note

Der Server enthält absichtlich keine Werkzeuge zum Senden von E-Mails oder Nachrichten, zum Planen von Meeting-Bots, zum Teilen von Transkripten, zum Löschen von Daten oder zum Durchführen von Aktionen in externen Diensten.

get_transcript liefert standardmäßig die Transkript-Zusammenfassung. Sie kann verknüpfte Aufgaben und zur Abfrage passende Sprecherblöcke enthalten, lädt aber standardmäßig nie jeden Transkriptbeitrag einzeln.

Anmelden und Trennen

Der Server läuft lokal über STDIO. Beim Start ist kein Sitzungstoken erforderlich.

Rufen Sie login ohne Argumente auf. Es gibt eine anklickbare, kurzlebige URL zurück, die wie folgt erreichbar ist:

• http://localhost:3100

Öffnen Sie die URL und wählen Sie Mit Google anmelden. Die offizielle Google-Anmeldung öffnet sich außerhalb des eingebetteten Codex-Browsers. Der lokale MCP-Server tauscht die Google-Anmeldedaten mit ZeroHrs aus und validiert die zurückgegebene Sitzung über /auth/profile. Weder Google-Anmeldedaten noch ein ZeroHrs-Sitzungstoken werden über den Codex-Chat übertragen. Die URL läuft nach zehn Minuten ab. Nach Erfolg, Ablauf oder Trennung werden keine weiteren Anmeldeanfragen mehr angenommen.

Die Browser-Anmeldung enthält die öffentliche Google-Client-ID der ZeroHrs-Produktionsumgebung. Administratoren können sie mit ZEROHRS_GOOGLE_WEB_CLIENT_ID oder GOOGLE_WEB_CLIENT_ID überschreiben. Für die Entwicklung im Repository kann GOOGLE_WEB_CLIENT_ID auch aus backend/control-plane/.env ausgelesen werden. Der Google-Web-Client muss http://localhost:3100 als JavaScript-Origin autorisieren. Setzen Sie ZEROHRS_MCP_LOGIN_PORT nur, wenn dieser alternative localhost-Origin ebenfalls autorisiert ist.

Das API-Ziel wird nicht aus dem Tool-Aufruf übernommen. Es ist standardmäßig auf https://control-plane.zerohrs.com gesetzt und kann vor dem Start von Codex vom Administrator über ZEROHRS_API_BASE_URL festgelegt werden, beispielsweise wenn eine lokale oder Staging-Control-Plane verwendet wird.

Nach der Browser-Anmeldung wird nur das validierte ZeroHrs-Token unter ~/.zerohrs/codex-mcp-session.json mit den Berechtigungen 0600 gespeichert. Die gespeicherte Sitzung wird sofort aktiv, ohne dass Codex neu gestartet werden muss.

Rufen Sie disconnect auf, um eine ausstehende Browser-Anmeldung abzubrechen und die lokale Datei mit Anmeldedaten zu entfernen. Dabei wird weder /auth/logout aufgerufen, noch das Token widerrufen, noch eine andere ZeroHrs-App-Sitzung abgemeldet. Ein erneuter Aufruf ist unbedenklich.

Fügen Sie ein Sitzungstoken weder in .codex/config.toml noch in eine eingecheckte .env-Datei, in /etc/chat oder den Shell-Verlauf ein. Das gespeicherte Token wird ausschließlich als Authorization: Bearer <token> an die vom Administrator konfigurierte ZeroHrs-API-URL gesendet. Die Control-Plane bleibt für die Zugriffskontrollen der Benutzer auf Meetings, Transkripte, Aufgaben, Kontakte, Vorbereitungsnotizen und Briefings verantwortlich.

Starten Sie Codex neu, nachdem Sie diesen MCP-Server hinzugefügt oder aktualisiert haben, und verwenden Sie dann /mcp, um zu bestätigen, dass der zerohrs-Server und seine Werkzeuge verfügbar sind.

Inhalt des Releases

Dieses Repository enthält die eigenständige öffentliche Distribution. Das ausführbare Bundle ist dist/index.mjs; seine Laufzeitabhängigkeiten bleiben gewöhnliche npm-Pakete.