Support

Requirements: macOS, HomeBar Pro or higher, Accessibility permission.

Trigger HomeKit scenes and devices from anywhere on your Mac with a keyboard combo. No need to switch apps.

Setup

1. Open HomeBar → click the menu bar icon → Settings → Keyboard Shortcuts.
2. Click Add Shortcut.
3. Choose an action:
   • Run Scene — pick from your HomeKit scenes
   • Toggle Device — pick a device to flip on/off
   • Set Device Value — pick a device, characteristic, and target value (e.g. brightness = 80)
4. Click in the key field and press your shortcut. Must include at least one modifier (⌘ ⇧ ⌥ ⌃) plus a letter, number, or function key.
5. macOS will ask for Accessibility permission the first time. Approve it in System Settings → Privacy & Security → Accessibility.

Usage

Press the shortcut from any app — Mail, Safari, Final Cut, anywhere. The action fires instantly.

Examples

• ⌘⌥G → Run "Good Night" scene
• ⌘⇧L → Toggle "Office Light"
• ⌃⌥B → Set "Bedroom Light" brightness to 30%

Limit: up to 20 shortcuts.

Requirements: macOS, HomeBar Pro or higher. No additional setup — HomeBar's scripting dictionary is registered automatically.

Drive HomeBar from Script Editor, Automator, or any app that supports AppleScript.

Discover the dictionary

1. Open Script Editor (in /Applications/Utilities).
2. File → Open Dictionary… → pick HomeBar.
3. Browse the supported commands.

Commands

Command	Example
run scene	tell application "HomeBar" to run scene "Good Night"
run scene in home	tell application "HomeBar" to run scene "Evening" in home "Living Room"
update device	tell application "HomeBar" to update device "Office Light" characteristic "brightness" to 80
toggle device	tell application "HomeBar" to toggle device "Front Door Lock"
get device state	tell application "HomeBar" to get device state "Office Light" (returns JSON)
list scenes	tell application "HomeBar" to list scenes
list devices	tell application "HomeBar" to list devices

Multi-step example

tell application "HomeBar"
    run scene "Morning Routine"
    update device "Kitchen Light" characteristic "brightness" to 100
    toggle device "Coffee Maker"
end tell

Each command times out after 15 seconds and returns a status string you can use in Automator workflows or Shortcuts.

Browse and control your home from Raycast's command bar. Official extension included.

Setup

1. In HomeBar: Settings → AI → MCP Server → toggle on. Copy the bearer token.
2. In Raycast: Store → search "HomeBar" → install. (or load the local extension from extensions/raycast-homebar/ for development)
3. Open Raycast preferences → HomeBar → paste the bearer token. Optionally set host (default 127.0.0.1), port (default 5333), and temperature unit (°F or °C).

Commands

• List Scenes — browse all scenes, press ⏎ to run
• List Devices — browse by room, control inline:
  • Lights / switches / outlets / fans → toggle power
  • Blinds → set position 0–100% (with open / close / half-open shortcuts)
  • Thermostats → set temperature, set mode (Off/Heat/Cool/Auto), toggle power
  • Security systems → set state (Disarm / Stay / Away / Night)
• Run Scene — quick action with a scene-name argument (no view)

Tip: every device row offers Copy ID and Copy URL Scheme actions — handy for piping into your own scripts or Shortcuts.

Example

Open Raycast → type Run Scene Good Night → press ⏎.

Same idea as Raycast, packaged as an Alfred workflow.

Setup

1. Install the HomeBar CLI (see CLI section below) and run homebar auth <token> to save your MCP credentials. Alfred uses the same config file.
2. In HomeBar: Settings → AI → MCP Server → toggle on if you haven't already.
3. Download the workflow from extensions/alfred-homebar/ and double-click HomeBar.alfredworkflow to import.

Keywords

Keyword	What it does
hb scenes	List scenes; ⏎ to run
hb devices	List devices; ⏎ to toggle
hb run <scene>	Run a scene by name
hb toggle <device>	Toggle a device by name
hb status	Show home summary (devices online, low battery, etc.)

Example

Type hb run Good Night in Alfred → press ⏎.

The workflow uses HomeBar's URL scheme for actions and the MCP server for live device/scene listings.

Scriptable command-line tool. Works in shell scripts, cron jobs, CI hooks, and Stream Deck buttons.

Install

# Build from source
cd HomeBarCLI
swift build -c release
sudo cp .build/release/homebar /usr/local/bin/

# Verify
homebar --help

One-time auth

1. In HomeBar: Settings → AI → MCP Server → toggle on, copy the bearer token.
2. Run:

homebar auth <paste-token-here>
# Optional: --host 192.168.1.100 --port 5333

Credentials are saved to ~/.config/homebar/config.json.

Commands

homebar devices                  # list all devices
homebar scenes                   # list all scenes
homebar status                   # home summary (device counts, low battery, etc.)

homebar run "Good Night"         # run a scene
homebar run "Evening" --home "Living Room"

homebar toggle "Office Light"    # toggle a device's power
homebar set "Office Light" brightness 80   # set a characteristic value

Add --json to any command for machine-readable output:

homebar devices --json | jq '.[] | select(.reachable == false)'

Tip: values are auto-parsed — true/false/on/off/yes/no become booleans, numbers become numbers, everything else is a string.

Requirements: HomeBar Pro or higher, an MCP-compatible AI client (Claude Desktop, Cursor, Raycast AI, etc.).

Expose HomeBar to AI assistants via the Model Context Protocol. Ask in plain English: "turn off the office light," "what's the temperature in the bedroom," "run Good Night."

Setup

1. In HomeBar: Settings → AI → MCP Server → toggle on. Copy the server URL (default http://127.0.0.1:5333) and bearer token.
2. Set per-device permissions in the same panel — choose which devices and rooms the AI can see and control.
3. Add HomeBar to your MCP client (examples below).
4. Restart the client and ask it to control your home.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "homebar": {
      "url": "http://127.0.0.1:5333",
      "headers": { "Authorization": "Bearer <paste-token-here>" }
    }
  }
}

Restart Claude Desktop. HomeBar's tools will appear in the 🔌 menu.

Cursor / other MCP clients

Add a remote MCP server using the same URL and an Authorization: Bearer <token> header.

What the AI can do

• Discover your devices, rooms, scenes, and automations
• Read sensor values (temperature, motion, contact, energy)
• Trigger scenes, toggle devices, and set values — within the permissions you grant
• Run automations on demand

Examples

• "Turn off all the lights downstairs."
• "What's the temperature in the bedroom?"
• "Run the Movie Night scene."
• "Are any windows still open?"

Tip: keep cameras, locks, and security systems hidden or read-only by default — the AI can't access what you don't expose.

The lowest-friction integration. Works from Safari, Shortcuts, Stream Deck, Keyboard Maestro, BetterTouchTool, an <a href> tag, even a QR code. No setup required.

Scheme: homebar://

Patterns

URL	Action
homebar://scene/Good%20Night	Run a scene
homebar://scene/Evening?home=Living%20Room	Run a scene in a specific home
homebar://device/Office%20Light/toggle	Toggle a device
homebar://device/Office%20Light/set?characteristic=brightness&value=80	Set a characteristic
homebar://device/Office%20Light/state	Read current state
homebar://run-automation/Evening%20Mode	Toggle an automation on/off
homebar://devices	List devices
homebar://scenes	List scenes
homebar://status	Open HomeBar to its summary view

Encoding: spaces → %20. Most apps will encode for you.

Examples

# Terminal
open "homebar://scene/Good%20Night"
open "homebar://device/Office%20Light/set?characteristic=brightness&value=80"

<!-- Web page -->
<a href="homebar://scene/Good%20Night">🌙 Good Night</a>

Apple Shortcuts:
  Action: Open URL
  URL:    homebar://scene/Morning%20Routine

Stream Deck (System → Open):
  URL: homebar://device/Living%20Room%20Light/toggle

Tip: every Raycast/Alfred device row has a "Copy URL Scheme" action — generate the URL once, paste it wherever you need it.