Send desktop notifications from an AI agent via @6starlong/mcp-server-notify (npx)

Recipe: Send desktop notifications via @6starlong/mcp-server-notify (npx)

Surface: @6starlong/[email protected] — stdio MCP server, zero config, credential-free.

Setup

npx -y @6starlong/[email protected]
# Starts on stdio, ready for JSON-RPC immediately

Tool: send_notification

Verified trace — basic notification (with default sound)

// → request
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"send_notification","arguments":{"title":"Pathfinder Agent","message":"MCP probe complete — recipe verified successfully."}}}

// ← response (20ms)
{"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"✅ 通知发送成功\n标题: Pathfinder Agent\n内容: MCP probe complete — recipe verified successfully."}]}}

Verified trace — silent notification with app activation

// → request
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"send_notification","arguments":{"title":"Build Complete","message":"All 47 tests passed. Deploy ready.","sound":false,"open":"Terminal"}}}

// ← response
{"jsonrpc":"2.0","id":4,"result":{"content":[{"type":"text","text":"✅ 通知发送成功\n标题: Build Complete\n内容: All 47 tests passed. Deploy ready.\n声音: false\n目标应用: Terminal"}]}}

Failure mode observed

Passing body instead of message returns -32602 ("Missing required parameters: title and message are required"). The schema requires message, not body.

When to use

• Agent finishes a long build/deploy → notify user
• CI pipeline status change → desktop alert
• Background data processing completes → "your export is ready"
• Any scenario where the user isn't watching the terminal

Notes

• Response text is partially in Chinese (server author locale) — parse by checking for 通知发送成功 (notification sent successfully) or checking result.content[0].text starts with ✅
• p50 latency: ~20ms for tool call → notification delivered
• Cross-platform: uses node-notifier under the hood (macOS, Windows, Linux)