Notify User

Use the notify_user tool to send notifications to the user's configured platforms (native OS, Gotify, Telegram).

When to use notify_user

• Critical errors that need immediate attention
• Completion of long-running tasks (after user has been waiting)
• Security concerns or suspicious activity detected
• Results that the user explicitly asked to be notified about

When NOT to use notify_user

• Routine status updates (use normal message instead)
• Non-urgent information (let user read at their pace)
• Every turn completion (spammy)

Parameters

Parameter	Type	Default	Description
message	string	required	Notification body
title	string?	"Pi Notification"	Notification title
priority	string?	"normal"	"low", "normal", or "high"
platforms	string[]?	all enabled	Override which platforms to use

Examples

Alert on critical error:

notify_user({
  title: "Build Failed",
  message: "TypeScript compilation failed with 12 errors. Check src/auth.ts.",
  priority: "high"
})

Task completion:

notify_user({
  title: "Deployment Complete",
  message: "Successfully deployed to production. All health checks passed.",
  priority: "normal"
})