@reflecto/mcp

Let any MCP-capable LLM agent — Claude Desktop, Claude Code, Cursor, Windsurf, VS Code — send push notifications to your own Reflecto paired devices (your phone and desktop).

"Notify my phone when this build finishes." — and it does.

Prerequisites

• Reflecto installed on your phone, with at least one paired device.
• A sender token (rfk_live_…). Create one in the Reflecto Android app under API Tokens. Tip: make a dedicated token labeled for the agent (e.g. "Claude") — it shows as the source on your device and can be revoked on its own.

Configure your client

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "reflecto": {
      "command": "npx",
      "args": ["-y", "@reflecto/mcp"],
      "env": { "REFLECTO_TOKEN": "rfk_live_…" }
    }
  }
}

Claude Code

claude mcp add reflecto --env REFLECTO_TOKEN=rfk_live_… -- npx -y @reflecto/mcp

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "reflecto": {
      "command": "npx",
      "args": ["-y", "@reflecto/mcp"],
      "env": { "REFLECTO_TOKEN": "rfk_live_…" }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "reflecto": {
      "command": "npx",
      "args": ["-y", "@reflecto/mcp"],
      "env": { "REFLECTO_TOKEN": "rfk_live_…" }
    }
  }
}

VS Code — .vscode/mcp.json

Note: VS Code uses a servers key, not mcpServers.

{
  "servers": {
    "reflecto": {
      "command": "npx",
      "args": ["-y", "@reflecto/mcp"],
      "env": { "REFLECTO_TOKEN": "rfk_live_…" }
    }
  }
}

Tool

send_notification

| Field | Type | Notes | |------|------|-------| | message | string (required) | Body. ≤1500 bytes. | | title | string | Headline. ≤100 bytes. | | priority | min|low|default|high|urgent | default+ wakes the device. | | device | string | all (default), phone/mobile, desktop, or comma-separated labels. | | url, url_title | string | Tappable link + its label. Android only in v1; the desktop extension ignores them. | | actions | {label,url}[] | Up to 3 buttons. | | tags | string[] | Up to 5 labels. | | ttl | number | Seconds queued if undelivered (≤72h); floats are floored by the server. |

Environment variables

• REFLECTO_TOKEN (required) — your rfk_live_… sender token.
• REFLECTO_API_URL (optional) — override the API base URL (default https://api.reflecto.dev).

Privacy

This server is a thin client over Reflecto's public Send API. It sends only what the agent asks it to send, over HTTPS. Your token is the only credential; keep it out of shared configs and revoke it from the app if it leaks. Full docs: https://docs.reflecto.dev

License

MIT