Volver al blog

Notificaciones push para Cursor: un aviso cuando el agente termina

Notificaciones push para Cursor: un aviso cuando el agente termina

El agente de Cursor puede refactorizar un módulo mientras preparas un café, pero en una ejecución local normal Cursor te avisa de que ha terminado solo en el ordenador: con un sonido, o con una notificación del sistema si los activaste. La app de Cursor para iOS envía notificaciones push cuando un agente termina un turno, pero solo para agentes en la nube y sesiones que pasas con Remote Control, con un plan de pago y un iPhone. Android está previsto.

Si quieres una notificación push en el teléfono cuando termina una ejecución local, Cursor te ofrece dos formas de enviarla:

  • Un hook stop. Cursor ejecuta tu script cada vez que termina el bucle del agente, ya sea que se completó, se abortó o dio un error. Fiable, igual en cada ocasión.
  • Una herramienta MCP. Añade el servidor MCP de Pocket Alert y el agente podrá enviarte una notificación push cada vez que se lo pidas, con un mensaje que él mismo escribe.

Esta guía configura las dos. Cada una te lleva unos minutos.

Qué necesitas

  • Cursor 1.7 o posterior; los hooks llegaron en la 1.7.
  • jq y curl para el hook.
  • Una cuenta de Pocket Alert, una clave de API desde API Keys y la app en tu teléfono. El plan gratuito basta.

Cursor abierto desde el Dock no lee tu .zshrc, así que las variables de entorno que exportes ahí le son invisibles. Guarda la clave en un archivo:

mkdir -p ~/.config/pocketalert
printf '%s' 'YOUR_API_KEY' > ~/.config/pocketalert/key
chmod 600 ~/.config/pocketalert/key

Opción 1. Un hook stop para cada ejecución

El script

Cursor pasa al hook un objeto JSON por stdin. Para stop incluye status (completed, aborted o error) y workspace_roots, las carpetas abiertas en la ventana. Guarda esto como ~/.cursor/hooks/pocketalert.sh:

#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.workspace_roots[0] // "cursor"' <<<"$payload")")
status=$(jq -r '.status // "completed"' <<<"$payload")

case "$status" in
  completed) title="Cursor finished · $project"; level=default ;;
  error)     title="Cursor hit an error · $project"; level=high ;;
  *)         echo '{}'; exit 0 ;;
esac

jq -n --arg t "$title" --arg m "Agent run $status" --arg l "$level" \
  '{title: $t, message: $m, level: $l}' |
  curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
    -H "Token: $(cat ~/.config/pocketalert/key)" \
    -H 'Content-Type: application/json' \
    --data-binary @- >/dev/null 2>&1 || true

echo '{}'
chmod +x ~/.cursor/hooks/pocketalert.sh

Las ejecuciones abortadas se omiten a propósito: si pulsaste detener, ya lo sabes. El script imprime {} porque un hook stop puede devolver un followup_message que Cursor envía de vuelta al agente como tu siguiente prompt; un objeto vacío significa «nada que añadir».

O con la CLI de Pocket Alert

Con la CLI de Pocket Alert 2.0 o posterior instalada, el bloque de curl se reduce a un comando. La CLI escapa el texto por sí misma y toma la clave de pocketalert auth:

pocketalert send -t "$title" -m "Agent run $status" -l "$level" -q >/dev/null 2>&1 || true

Usa -t y -m en lugar de argumentos posicionales: una respuesta que empiece por un guion, como una lista Markdown, se leería como una opción.

Regístralo

Crea ~/.cursor/hooks.json:

{
  "version": 1,
  "hooks": {
    "stop": [
      { "command": "/Users/you/.cursor/hooks/pocketalert.sh", "timeout": 10 }
    ]
  }
}

Usa la ruta absoluta del script; sustituye /Users/you por tu carpeta personal. El archivo de tu carpeta personal se aplica a todos los proyectos. Si quieres solo uno, ponlo en .cursor/hooks.json dentro del repositorio.

Cursor vuelve a cargar hooks.json por sí mismo cuando el archivo cambia. Dale al agente una tarea pequeña, y cuando termine verás en el teléfono Cursor finished · your-project.

¿Quieres la respuesta del agente en la notificación?

stop no incluye la respuesta del agente, pero afterAgentResponse sí la incluye, en text. Para enviar las primeras líneas de la respuesta en lugar de solo el estado, registra un script del mismo tipo en afterAgentResponse y lee .text desde stdin. Se dispara después de cada respuesta, así que hace más ruido; la mayoría se queda con stop.

Opción 2. El servidor MCP

El hook te dice que una ejecución ha terminado. El servidor MCP permite que el agente te cuente qué ha pasado. Añade Pocket Alert a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pocketalert": {
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

La clave se escribe en el archivo por el problema del Dock que vimos antes. Este archivo vive en tu carpeta personal, no en un repositorio. Si inicias Cursor desde una terminal con la clave exportada, "Bearer ${env:POCKETALERT_API_KEY}" funciona en su lugar.

Abre la sección MCP de la configuración de Cursor, comprueba que pocketalert muestra sus herramientas y pregunta:

> Run the test suite. When it's done, push me the number of failures with Pocket Alert.

El agente llama a create_message con un resumen que él mismo escribió. También puede establecer level, así que una suite que falla puede llegar como high, y adjuntar botones de acción con un plan de pago.

Para que sea un hábito y no una instrucción en cada prompt, añade una regla de proyecto:

When a task takes more than a few minutes, finish by calling the pocketalert
create_message tool with a one-line summary. Use level "high" if anything failed.

Cuál usar

Hook stopHerramienta MCP
Se disparaEn cada ejecución, siempreCuando el agente decide hacerlo
MensajeEstado: completed o errorLo que escriba el agente
NecesitaUn script y hooks.jsonUn bloque en mcp.json
Puede fallar en silencioSolo si no hay redSi el modelo se olvida

Usar las dos juntas es una buena opción por defecto: el hook garantiza que te enteres de cada ejecución, y la herramienta MCP te da el contenido cuando importa.

Aprobaciones

Cursor no tiene un hook para «el agente está esperando una aprobación». beforeShellExecution y preToolUse se disparan antes de cada comando, incluidos los que Cursor ejecuta sin preguntar, así que no pueden avisarte de cuándo te necesitan de verdad. Las notificaciones de escritorio de Cursor y su app para iOS cubren ese caso hoy.

Si quieres que el agente se detenga y te pregunte antes de un paso arriesgado, dale la herramienta MCP y una regla para enviar una notificación push con botones de Aprobar y Rechazar; Notificaciones con intervención humana explica cómo convertirlo en una puerta real y no en una petición educada.

Si no llega nada

  • Ejecuta el script a mano: echo '{"status":"completed","workspace_roots":["/tmp/demo"]}' | ~/.cursor/hooks/pocketalert.sh. Si no llega ninguna notificación, quita >/dev/null 2>&1 para ver el error de curl.
  • Reinicia Cursor si el hook sigue sin ejecutarse. Normalmente Cursor recarga hooks.json por sí mismo cuando el archivo cambia.
  • Comprueba que la ruta en hooks.json es absoluta y que el script es ejecutable.
  • En MCP, revisa la lista de herramientas. Un error junto al servidor en la configuración MCP de Cursor suele indicar que la clave es incorrecta o está vacía.

Preguntas frecuentes

¿Cursor tiene notificaciones push integradas?

En el ordenador, sí: un sonido al completar y notificaciones del sistema. En el teléfono, la app de Cursor para iOS envía notificaciones push cuando termina un turno de un agente en la nube, o de una sesión que pasas con Remote Control. Necesita un plan de pago y un iPhone. Las ejecuciones locales normales se quedan en el ordenador, y eso es lo que cubre la configuración de esta guía.

¿Funciona con agentes en segundo plano y en la nube?

El hook de ~/.cursor/hooks.json solo se ejecuta en tu máquina, así que cubre los agentes que se ejecutan en local. Los agentes en la nube se ejecutan en los servidores de Cursor: ejecutan los hooks del proyecto desde el .cursor/hooks.json del repositorio, pero no los hooks de usuario, y el archivo de clave no está allí. Para ellos, la vía MCP funciona si el agente tiene el servidor configurado, o puedes usar la app de Cursor para iOS o la integración con Slack.

¿El agente ve mi clave de API?

En la configuración del hook, no: la clave se queda en un archivo que solo lee el script. En la configuración MCP, la clave está en la configuración de Cursor y se envía al servidor MCP, no al modelo.

¿Es gratis?

Sí. Los hooks y MCP forman parte de Cursor, y el plan gratuito de Pocket Alert incluye 50 mensajes al día en un dispositivo.

Obtén una clave de API, añade el hook y deja que Cursor te avise cuando termine.

Comparte este artículo