This server provides a comprehensive MCP interface for monitoring and (optionally) controlling Xiaomi Mi Home (米家) smart home devices.

Read / Monitoring Tools (always available)

• get_home_snapshot — Fetch a full snapshot of all home devices organized by home → room → device, with semantic state translation, offline/low-battery alerts, and 30-second caching

• get_home_changes — Get a diff of what changed since the last snapshot (property changes, devices going online/offline, devices added/removed)

• query_history — Query local event history (e.g., door open times, washing machine cycles), filterable by device, property, event type, and time range; data retained for 30 days

• list_homes / list_devices — List all homes/rooms with device counts, or enumerate devices with name/model/online status/room

• get_device_status / get_device_spec — Get detailed status of a single device, or its specs (supported properties, actions, read-write/range/enum info)

• list_scenes — List Mi Home manual scenes

• list_consumables — Check consumable status (filters, brush heads, etc.) and which need replacement

• get_battery_report — Full battery survey of all battery-powered devices, sorted by level ascending

• get_device_statistics — Historical statistics (e.g., power consumption, usage duration) for a device

• auth_status / login / login_status — Check login status, initiate QR code login if credentials expire, or check login progress

Control Tools (require --enable-control flag)

• set_device_property — Set a property on a device (e.g., turn on a light, set temperature)

• run_device_action — Execute an action on a device

• run_scene — Trigger a Mi Home manual scene

• speaker_announce — Make a Xiaomi smart speaker announce a message

• run_speaker_command — Have a Xiaomi smart speaker execute a natural language command (treated as dangerous)

Notification Tool

• send_notification — Push notifications to all configured channels simultaneously (Xiaomi Speaker, MeoW, Bark, ntfy, Feishu, DingTalk, generic webhook)

Key Safety & Other Features

• Dangerous devices (locks, cameras, gas/water valves, safes) require an additional --allow-dangerous flag even with --enable-control

• All write operations (including rejected ones) are logged to an audit log

• Multi-home support with options to lock to a default home or override per query

• Standalone CLI capabilities: self-diagnosis (doctor), snapshots, device/battery listing, speaker messaging, and continuous change monitoring (watch)

• MCP resources for clients that support them, offering device lists, home structure, and real-time snapshots

Allows sending notifications to ntfy.sh or a self-hosted ntfy server, providing real-time alerts about home events and device changes.

Allows monitoring and control of Xiaomi smart home devices (米家 ecosystem), including reading device states, executing actions, and receiving notifications about home changes.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mijia-home-mcp show me the current state of my home"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.