Repository navigation
v0.1.0
First release of mcp-server-harmony: an MCP server that controls one or more Logitech Harmony Hubs over their local websocket API (no Logitech cloud, no Home Assistant), built on aioharmony.
What's in it
- Tools:
get_status,list_activities,list_devices,list_commands,start_activity,power_off,send_command - Resources:
harmony://hubsand a per-hub catalog; prompt:fix_stuck_remote - Activity-first:
send_commandwithout a device goes through the running activity - Multiple hubs, never guessed: ambiguous calls are refused with the hub names; hub-qualified refs like
Den/Watch TV - Safety: the hub's config is the allow-list; commands refused mid-sequence; per-hub rate limits; dry-run mode
- CLI:
serve(stdio or--http),check,call,discover,doctor,simulate(wire-level fake hubs) - Deploy: Alpine/OpenRC service for an LXC
Verification status
Hardware-verified on real hubs (2026-10-14): H-FRAMES, H-NAME, H-PORT, H-POWEROFF, H-PROVISION (connect, status, names, power off).
Simulator-only so far: H-CONFIG-PUSH, H-CONFIG-SHAPE, H-HOLD, H-PRESS-ERROR, H-PRESS-SILENT, H-RECONNECT, H-SSDP, H-START-SEQUENCE, H-TIMING (activity starts, button presses, reconnects, config pushes). See HARDWARE_VALIDATION.md.
Tested on Python 3.11–3.14.