Myro:Home Helper MCP server

Lets an AI assistant (Claude Desktop, Claude Code, ChatGPT desktop, anything that speaks MCP) read and control an HAI/Leviton Omni controller through Myro:Home Helper, using the Helper's HTTP API. The assistant sees typed tools with descriptions instead of guessing URL shapes.

What you need

Myro:Home Helper 4.06 or later on a Mac on your network (4.07 or later for the read tools: list_objects, get_object, helper_log).
An API key for your controller: Helper → API tab → Generate.
uv on the machine running the assistant (brew install uv or the one-line installer). uvx fetches and runs this server on demand and keeps it updated.

Configure

Claude Desktop (claude_desktop_config.json) or any client that takes the standard MCP config:

{
  "mcpServers": {
    "myrohome-helper": {
      "command": "uvx",
      "args": ["myrohome-helper-mcp"],
      "env": {
        "MHH_URL": "http://192.168.1.76:9393",
        "MHH_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code:

claude mcp add myrohome-helper -e MHH_URL=http://192.168.1.76:9393 -e MHH_API_KEY=your-api-key -- uvx myrohome-helper-mcp

The controller ID is fetched from the Helper automatically. Set MHH_CONTROLLER_ID only if you want to pin it.

Tools

Read:

Tool	What it returns
`helper_info`	Helper version and identity, and which controller the key is for
`controller_status`	Name, model, firmware, connection, power, battery, phone line, energy cost, troubles
`controller_property(name)`	One controller property
`list_objects(type?)`	Every object with decoded state; filter by Zone, Unit, Flag, Output, Thermostat, Auxiliary Sensor, …
`get_object(type, number)`	One object
`helper_log(lines)`	The Helper's recent log lines
`ethernet_quality`	The controller connection's health record
`sensor_history(type, number, points)`	Logged readings for a sensor or thermostat

Write (each changes the physical home; tool descriptions tell the assistant to confirm first):

Tool	Effect
`set_unit(number, value)`	0 off, 1 or 100 on, 2–99 dimmer level
`set_flag(number, value)`	Flag to 0–255
`set_output(number, on)`	Output relay on or off
`set_energy_cost(level)`	low / medium / high / critical
`send_notification(message)`	Push to the Myro:Home apps
`speak(message)`	Speak on the Mac
`log_message(message)`	Write to the Helper log
`sync_now`	Re-sync from the controller

There are deliberately no arming or disarming tools.

Security

This server runs on your LAN like every other Myro:Home client and holds one controller's API key. Anyone who can run the assistant with this config can do what the key allows. Keep it on trusted machines. The Helper's HTTP API is plain HTTP on the local network; do not expose port 9393 to the internet.

Developing

uv sync
MHH_URL=http://192.168.1.76:9393 MHH_API_KEY=... uv run myrohome-helper-mcp   # stdio server
uv run mcp dev src/myrohome_helper_mcp/server.py                             # MCP inspector

Releasing

Bump version in pyproject.toml and __init__.py, commit, then tag and push: git tag v0.1.0 && git push origin v0.1.0. The GitLab CI job builds and publishes to PyPI through trusted publishing (one-time setup: PyPI project -> Publishing -> add GitLab publisher MyroControl/myrohome-helper-mcp, environment pypi).

MIT licensed. Myro Control, LLC.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

myrohome_helper_mcp-0.1.0.tar.gz (64.7 kB view details)

Uploaded Sep 4, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

myrohome_helper_mcp-0.1.0-py3-none-any.whl (7.9 kB view details)

Uploaded Sep 4, 2026 Python 3

File details

Details for the file myrohome_helper_mcp-0.1.0.tar.gz.

File metadata

Download URL: myrohome_helper_mcp-0.1.0.tar.gz
Upload date: Sep 4, 2026
Size: 64.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for myrohome_helper_mcp-0.1.0.tar.gz
Algorithm	Hash digest
SHA256	`5b3bfdb2104633fc8b450b427fb72ef7fd8374d38071d7ceaf68a9eee2a86c59`
MD5	`7500c4234abaab0e3440262da7879a75`
BLAKE2b-256	`310e71d0a92d7be3feac26006cb99e86f362bc10eb62ab82ce9383c86214a557`

See more details on using hashes here.

File details

Details for the file myrohome_helper_mcp-0.1.0-py3-none-any.whl.

File metadata

Download URL: myrohome_helper_mcp-0.1.0-py3-none-any.whl
Upload date: Sep 4, 2026
Size: 7.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for myrohome_helper_mcp-0.1.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`18a584f16f85c55919ef41fb09818219d93ea72338bb145b21b8657d1308d6fe`
MD5	`e8d0266cbbe9e555cc91df521957f766`
BLAKE2b-256	`09ba71e120e91b8c9bb2374d52c6c042595412bea0c5020679bf443c1ea50d95`