Shortcuts Buttons
homebridge-shortcuts-buttons · v3.5.7
Adds buttons that run Apple Shortcuts on the Homebridge Mac, with optional callback commands.
What it says it supports
Devices it names
- Apple Shortcuts
Shows up in Apple Home as from its README
What people report
Needs the Homebridge host to be a Mac with the Shortcuts app; Raspberry Pi hosts cannot run shortcuts. Users want per-room buttons and remote macOS execution.
- Requested1
- Won’t be supported1
| Device | Status | What they said | Source |
|---|---|---|---|
| Remote macOS Shortcuts execution over SSH | Requested | Run shortcuts on a remote Mac from a Pi-hosted Homebridge.Saved copyCurrently, I run Homebridge on a Raspberry Pi, which is quite efficient, and I prefer to keep my main macOS machine free for primary tasks. I would like to see a feature that allows for the remote execution of macOS Shortcuts, potentially through an SSH interface or a dedicated API. Since the `shortcut` command-line tool already exists on macOS (e.g., `shortcut run "name"`), leveraging SSH to execute these commands remotely would be a viable solution. This would enable integrations where actions triggered by Homebridge events (or other remote systems) could then trigger macOS Shortcuts on my … Excerpt saved from GitHub on 2026-10-22. | Issue #93 · 2025-04 |
| Raspberry Pi running Homebridge (Apple Shortcuts host) | Won’t be supported | Plugin needs Shortcuts app on host, which exists only on macOS.Saved copyProblem: Shortcuts buttons not working I named the shortcuts as instructed with the same name as in shortcuts app . They show up in homekit but nothing happens when I turn them on. I saw the machine running homebridge must have access to icloud in my case I run homebridge on a raspberry pi. do I have to install icloud on the raspbery pi or is it another plugin in homebridge ? Couldn’t find any instructions on this.. Thanks in advance for the help. Excerpt saved from GitHub on 2026-10-22. | Issue #22 · 2024-06 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Runs Shortcuts on the Homebridge host via x-callback-url
You’ll need
- macOS 12+ host
- iCloud account with access to the Shortcuts
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^18.20.4 || ^20.18.0 || ^22.10.0 || ^24.8.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | HomebridgeShortcutsButtons |
| License | Apache-2.0 |
Community signals
| Downloads a week | 42 |
|---|---|
| Downloads a month | 146 |
| GitHub stars | 41 |
| Open issues | 6 |
| Closed issues | 8 |
| Last code push | 2026-01-26 |
| Latest version | 3.5.7 (2025-09-13) |
| First published | 2024-04-26 |
| Releases | 21 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
