cursor-peoplehub-mcp

MCP (stdio) para consultar y cargar horas en PeopleHub de Accusys vía /api/time-report.

Repositorio: github.com/PradellaNicolas/cursor-peoplehub-mcp

Nombre del servidor en Cursor: peoplehub.

Requisitos

• Node.js 20+

• Chromium de Playwright (solo para peoplehub_login)

• Cursor con MCP habilitado

Instalación

git clone https://github.com/PradellaNicolas/cursor-peoplehub-mcp.git
cd cursor-peoplehub-mcp
npm ci
npx playwright install chromium
npm run build

Opcional: copiar .env.example a .env si necesitás cambiar PEOPLEHUB_BASE_URL.

Cursor (~/.cursor/mcp.json)

"peoplehub": {
  "command": "node",
  "args": ["C:/Users/<tu-usuario>/projects/cursor-peoplehub-mcp/scripts/launcher.mjs"]
}

Ajustá la ruta al clone local (mismo patrón que cursor-workflow-hints-mcp). Recargá Cursor y verificá Settings → MCP (peoplehub en verde).

Primer uso

1. Ejecutá peoplehub_login desde el agente.

2. Se abre Chromium: Continuar con Microsoft (MFA si aplica).

3. Al llegar a Time Report, la sesión queda en %USERPROFILE%\.peoplehub-mcp\storage.json.

4. peoplehub_session para verificar.

5. peoplehub_list_week / peoplehub_log_hours (con confirm: true).

Cada usuario corre su propio peoplehub_login. No commitear .env ni storage.json.

MCP tools

Estado local

%USERPROFILE%\.peoplehub-mcp\

• storage.json — cookies de sesión (Playwright storage state)

• meta.json — metadata Supabase para refresh (si aplica)

Seguridad

• Auth por cookies Supabase/Azure; refresh automático cuando hay meta.json con anon key.

• Si expira la sesión: volver a peoplehub_login.

• peoplehub_log_hours no envía nada sin confirm: true.

Build

npm run build
npm start