MijiaPilot: MCP tool for Hermes Agent

Xiaomi Mijia smart-home platform with web UI, REST API, CLI, HomeKit bridge and MCP server for AI agents

What MijiaPilot does

The web interface covers device control, home and scene management, energy statistics, automation rules, dark mode and mobile layouts. A JWT-authenticated REST API with Swagger docs at /api/docs/ supports third-party integration, a mijia-control CLI handles login, device lists, property reads and writes and scene execution, and SocketIO pushes device state changes. Automation rules can trigger on cron, interval, sunrise or sunset.

The built-in MCP server lets AI agents such as Claude Code and Hermes Agent call device controls directly. A HomeKit bridge exposes Mijia lights, plugs, sensors and thermostats to Apple's Home app and Siri, and a BLE daemon reads Xiaomi Bluetooth temperature and humidity sensors from the PC. Device communication goes through the mijiaAPI Python SDK by Do1e. The README is available in Chinese, English, Japanese, Korean and Spanish.

Key features

Built-in MCP server for agents such as Claude Code and Hermes Agent
Web interface with device control, scenes, energy statistics and automation rules
JWT REST API with Swagger documentation
mijia-control CLI for login, device lists, property access and scenes
HomeKit bridge for Apple Home and Siri
BLE Bluetooth sensor daemon for local temperature and humidity data

When to use it

Letting Hermes Agent switch Xiaomi lights, plugs and climate devices through MCP tools
Controlling Mijia devices from Siri through the HomeKit bridge
Scheduling device automations by cron, interval or sunrise and sunset

Who it is for: Owners of Xiaomi Mijia smart-home devices who want to control them from a web app, the command line or AI agents.

How it fits with Hermes Agent

Supports Hermes Agent, alongside Claude Code, through its built-in MCP server, and the repository is tagged hermes-agent.

How to install MijiaPilot

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/handsomejustin/mijia-control.git
cd mijia-control
python -m venv venv && source venv/bin/activate
pip install -e ".[dev]"

Requirements: Python 3.10+, MySQL 5.7+ (SQLite is a fallback when DATABASE_URL is not set) and a Xiaomi account bound to the app

FAQ

What is MijiaPilot?

MijiaPilot is a smart-home platform for Xiaomi Mijia devices built with Flask. It provides a web interface, REST API, CLI, HomeKit bridge, BLE sensor support and an MCP server.

Does MijiaPilot work with Hermes Agent?

Yes, its built-in MCP server lets AI agents such as Claude Code and Hermes Agent call device controls directly. The repository is also tagged hermes-agent.

What do I need to run MijiaPilot?

You need Python 3.10 or newer and MySQL 5.7 or newer, although SQLite is used as a fallback when DATABASE_URL is not set. Device control also requires registering a user and binding a Xiaomi account.