Skip to main content
Glama
Sign In
workflow-hints

workflow-hints

by PradellaNicolas
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

cursor-workflow-hints-mcp

MCP + CLI para recordatorios de flujo en Cursor: estado local, nudges al agente, toasts Windows y contadores diarios (sesiones, edits, MCP, Plans).

Herramienta generica para equipos que usan Cursor. Nombre del servidor en Cursor: workflow-hints.

Requisitos

  • Node.js 20+

  • Windows (toasts; el core funciona sin notificaciones)

  • Cursor con hooks y MCP habilitados

Related MCP server: Claude Code Notification Hooks

Instalacion

cd <ruta-al-repo>
npm ci
npm run build
powershell -ExecutionPolicy Bypass -File .\hooks-bridge\Install-Cursor.ps1 -ReplaceLegacyWorkflowHints

-ReplaceLegacyWorkflowHints quita entradas legacy de otros packs en hooks.json (opcional).

Reinicia Cursor. Verifica Settings → MCP (workflow-hints) y Settings → Hooks.

CLI (hooks)

node dist/cli.js record --event session_start --conversation-id <id>
node dist/cli.js record --event file_edit --conversation-id <id> --path <abs>
node dist/cli.js morning-check --force
node dist/cli.js summary
node dist/cli.js context
node dist/cli.js dismiss --type all

MCP tools

Tool

Descripcion

hints_record_event

Registra evento y devuelve nudge

hints_get_context

Resumen para el agente

hints_get_daily_summary

Contadores estructurados

hints_set_preferences

Umbrales y toasts

hints_dismiss_nudge

Silenciar por tipo o todo el dia

Resource: hints://today

Estado local

%USERPROFILE%\.cursor\workflow-hints\

  • state.json — dia, contadores, conversaciones

  • config.json — umbrales (se crea al editar preferencias)

  • stack-hints.json — hints opcionales por patron de ruta (ver config/stack-hints.example.json)

Migracion automatica desde %USERPROFILE%\.cursor\pipol-hints\ y %USERPROFILE%\.cursor\workflow-hints-state.json si existen.

Tareas programadas (Windows)

Tarea

Cuando

WorkflowHints-MorningCheck

Al iniciar sesion (Startup)

WorkflowHints-EarlyCheck

Diario 9:00

WorkflowHints-MorningFollowup

Diario 10:30 si no hubo uso

Acceso directo en Escritorio: Cursor - Iniciar jornada

Tests

npm test
powershell -ExecutionPolicy Bypass -File .\test\Test-WorkflowHints.ps1

Desinstalacion

powershell -ExecutionPolicy Bypass -File .\hooks-bridge\Uninstall-ScheduledTasks.ps1

  1. Quitar workflow-hints de ~/.cursor/mcp.json

  2. Quitar entradas hooks/workflow-hints/ de ~/.cursor/hooks.json

  3. Borrar ~/.cursor/hooks/workflow-hints/ (opcional)

  4. Borrar ~/.cursor/workflow-hints/ (opcional)

Variables de entorno

WORKFLOW_HINTS_DATA_DIR — directorio alternativo para state/config.

Available Tools

5 tools
hints_dismiss_nudgeB

Dismiss nudges for today or mark a specific nudge type as sent.

Inputs: type.

hints_get_contextB

Get today's workflow summary as agent context.

Inputs: no named parameters.

hints_get_daily_summaryA

Get structured counters and timing for today.

Inputs: no named parameters.

hints_record_eventB

Record a Cursor workflow activity event and return optional nudge context.

Inputs: event (required), path, tool, mcp_server, +3 more.

hints_set_preferencesC

Update local hint thresholds and notification settings.

Inputs: workdays_only, notify_enabled, low_mcp_after_minutes, idle_threshold_minutes.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    B3.3/5.0

    Scored across 5 tools

    Disambiguation3/5

    Most tools map to distinct actions, but hints_get_context and hints_get_daily_summary both return today's workflow data and could be easily confused. The other three tools are clearly separated by their record, preference, and dismissal purposes.

    Naming Consistency5/5

    All tools use the consistent hints_ prefix with clear verb_noun snake_case names like record_event, set_preferences, and dismiss_nudge. The naming pattern is predictable and easy to follow.

    Tool Count5/5

    Five tools is well-scoped for a workflow-hints server. Each tool covers a distinct part of the workflow lifecycle without unnecessary bloat or redundancy.

    Completeness4/5

    The set covers event recording, context retrieval, daily summaries, preference updates, and nudge dismissal, forming a complete workflow loop. A minor gap is the lack of an explicit get-current-preferences endpoint, but agents can likely work around this.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Cursor Pro Limits MCP Server

      mehmetfiskindal
      A
      license
      B
      quality
      D
      maintenance
      Enables real-time monitoring of Cursor Pro usage limits and API quotas across different AI services. Tracks Sonnet 4.5, Gemini, and GPT-5 request usage with alerts when approaching subscription limits.
      6
      2 npm
      MIT

    • Claude Code Notification Hooks

      nkyy
      A
      license
      A
      quality
      D
      maintenance
      Provides automatic desktop notifications and contextual sounds for Claude Code operations across macOS, Windows, and Linux. It enhances the development experience by intelligently mapping specific event types to native system alerts and sounds.
      4
      7 npm
      3
      MIT