Hermes Shortcuts (Share Sheet, Siri, Photo)
From its catalog listing
Share to Hermes from any iPhone or Android app, ask Hermes with Siri and hear the answer, or photograph a receipt, whiteboard or document as a task. iOS Shortcuts and Android HTTP Shortcuts call one token-protected endpoint; replies return in the HTTP response and are forwarded to your Telegram home channel (a Siri question only when it says "save the answer" or times out). Setup is three steps: `hermes shortcuts pair` prints a QR code, the iPhone "Hermes Setup" shortcut scans it into iCloud Drive/Shortcuts/hermes.json, and the shared shortcuts (which contain no token) read it.
Good to know before installing
off until SHORTCUTS_TOKEN (32+ random chars; weak or placeholder tokens are refused) is set and the plugin is enabled; then the gateway runs an HTTP listener on 127.0.0.1:8645 (non-loopback bind needs SHORTCUTS_ALLOW_PUBLIC_BIND=true) that you expose through your own HTTPS tunnel or proxy. A single bearer token is the only authentication and every request acts as the owner. Requests run agent turns on shared, untrusted content; by default each action gets only the toolsets it needs (web, vision, plus memory for remember and cronjob for remind/ask; events get cronjob/todo only; no terminal, file, code execution, browser or MCP servers), enforced by toolsets_for_source and by a pre_tool_call hook that only acts in shortcuts sessions: it blocks any other tool, limits cronjob to create/list and makes created reminder jobs run once with no tools. `@file:`/`@url:`-style references in shared text are defanged (Hermes core would otherwise inline local files before the agent runs). Forwarded replies show URLs as code (no Telegram link previews). SHORTCUTS_TOOL_PROFILE=full opts into the platform's full toolset (then shared content can reach the terminal, directly or through cron jobs). Approvals are not bypassed. Uploads are cached in Hermes' media cache; sessions are stored in Hermes' session database; replies are sent to the configured platform's home channel. Registers the CLI command `hermes shortcuts pair`, which prints a QR code containing the server URL and SHORTCUTS_TOKEN (optional 0600 PNG; token text only with --show-token) and may query the local cloudflared metrics endpoint on 127.0.0.1:20241-20245 to find a quick-tunnel URL. On the phone the token is stored in plain text in iCloud Drive/Shortcuts/hermes.json (synced to iCloud; end-to-end encrypted only with Advanced Data Protection) or, with manual setup, inside the shortcut.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs (this one needs
SHORTCUTS_TOKEN), then asks whether to turn it on.hermes plugins install hermes-shortcuts - Said no? Turn it on later:
hermes plugins enable hermes-shortcuts - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Everyday life & fun · Chat apps & voice
- Maintained by
- sergo565456 (Community)
- Needs
SHORTCUTS_TOKENAPI key- Adds hooks
pre_tool_call- Works on
- linux, macos
- Needs Hermes
- 0.23.1 or newer
- Version
- 0.1.0
- In the catalog
- 2026-11-11, updated 2026-11-12
Known issues (from its catalog listing)
- Needs an HTTPS tunnel or reverse proxy (Cloudflare Tunnel, Tailscale, Caddy) for the phone to reach the loopback listener.
- No approval buttons on this surface: commands that need approval fail or time out; use Telegram for those.
- HEIC photos are rejected; the recipes convert to JPEG first.
- Prompt injection in shared pages or files cannot be fully prevented by fencing; the default safe tool profile limits what it can do. `remember` stores shared content in long-term memory, which every later session (including full-tool ones) sees; use it only on content you trust.
- Every shortcuts turn sees your memory/user profile like any session; a malicious page could try to make the agent put that text into a web_extract URL.
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in everyday life & fun
All everyday life & fun plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher