ZeroHrs MCP server

Este servidor público local MCP expone los datos de ZeroHrs del usuario con sesión iniciada a Codex. Utiliza la API de ZeroHrs y sus comprobaciones de autorización de usuario.

Para obtener una guía de instalación compartible y orientada a agentes, consulta INSTALL.md.

Instalación en Codex

Requiere Node.js 20 o superior. Inspecciona cualquier entrada zerohrs existente antes de reemplazarla y, a continuación, instala la versión pública etiquetada:

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

Establece default_tools_approval_mode = "writes" para este servidor en ~/.codex/config.toml, reinicia Codex y llama a la herramienta login sin argumentos.

Related MCP server: vibelogin-mcp

Herramientas

Herramientas de solo lectura:

• search_zero

• list_meetings

• list_transcripts

• search_transcripts

• get_transcript

• list_tasks

• get_task

• get_meeting_prep

Herramientas de escritura, cuya aprobación solicita Codex:

• login

• disconnect

• create_task

• update_task

• add_meeting_prep_note

El servidor no incluye herramientas para enviar correos electrónicos o mensajes, programar bots de reuniones, compartir transcripciones, eliminar datos ni realizar acciones en servicios externos.

get_transcript devuelve el resumen de la transcripción por defecto. Puede incluir tareas enlazadas y bloques de orador que coinciden con la consulta, pero nunca carga todos los turnos de la transcripción por defecto.

Inicio de sesión y desconexión

El servidor se ejecuta localmente sobre STDIO. No requiere un token de sesión al iniciarse.

Llama a login sin argumentos. Devuelve una URL clicable y de corta duración en:

• http://localhost:3100

Abre la URL y selecciona Iniciar sesión con Google. El inicio de sesión oficial de Google se abre en el navegador de tu sistema, fuera del navegador integrado de Codex. El MCP local intercambia la credencial de Google con ZeroHrs y valida la sesión devuelta mediante /auth/profile. Ninguna credencial de Google o token de sesión de ZeroHrs pasa a través del chat de Codex. La URL expira a los diez minutos y deja de escuchar tras una conexión correcta, la expiración o la desconexión.

El inicio de sesión en el navegador incluye el ID de cliente de Google público de producción de ZeroHrs. Los administradores pueden reemplazarlo con ZEROHRS_GOOGLE_WEB_CLIENT_ID o GOOGLE_WEB_CLIENT_ID. Para el desarrollo en el repositorio, también puede leer GOOGLE_WEB_CLIENT_ID desde backend/control-plane/.env. El cliente web de Google debe autorizar http://localhost:3100 como origen de JavaScript. Establece ZEROHRS_MCP_LOGIN_PORT solo cuando ese origen local alternativo esté también autorizado.

El destino de la API no se acepta en la llamada a la herramienta. El destino es https://control-plane.zerohrs.com y el administrador puede configurarlo mediante ZEROHRS_API_BASE_URL antes de iniciar Codex, por ejemplo al usar un plano de control local o de puesta en escena.

Después del inicio de sesión en el navegador, solo se guarda el token de ZeroHrs validado en ~/.zerohrs/codex-mcp-session.json con permisos 0600. La sesión guardada pasa a estar activa de inmediato, sin reiniciar Codex.

Llama a disconnect para cancelar cualquier inicio de sesión pendiente en el navegador y eliminar ese archivo de credenciales local. No llama a /auth/logout, no revoca el token ni finaliza ninguna otra sesión de la aplicación ZeroHrs. Si se vuelve a llamar, no se rompe nada.

No agregues un token de sesión a .codex/config.toml, a un archivo .env confirmado, al chat ni al historial de shell (terminal). El token guardado se envía únicamente como Authorization: Bearer <token> a la URL de la API de ZeroHrs configurada por el administrador. El plano de control sigue siendo el responsable de los controles de acceso del usuario a reuniones, transcripciones, tareas, contactos, notas de preparación y resúmenes.

Tras añadir o actualizar por primera vez este servidor MCP, reinicia Codex y usa /mcp para confirmar que el servidor zerohrs y sus herramientas están disponibles.

Contenido de la versión

Este repositorio contiene la distribución pública independiente. El paquete ejecutable es dist/index.mjs; sus dependencias en tiempo de ejecución son dependencias npm normales.