Mijia Smart Home Control

A skill/plugin for AI coding agents to control Xiaomi Mijia smart home devices through natural language commands.

Works with:

• OpenClaw - Open source AI coding agent
• Claude Code
• OpenCode
• Droid
• Other AI coding assistants that support custom skills/tools

Features

• Control Xiaomi Mijia smart devices via natural language
• Support for desk lamps, smart plugs, and other Mijia devices
• Brightness and color temperature adjustment
• Multiple lighting modes (reading, computer, night, etc.)
• Easy to extend for additional device types

Prerequisites

• Python 3.13+
• uv package manager
• Xiaomi account with Mijia devices

Installation

1. Clone this repository:

git clone https://github.com/user/mijia-skill.git
cd mijia-skill

1. Install dependencies:

uv sync

1. Configure your device ID:

export MIJIA_LAMP_DID="your_device_id"

1. First run will prompt for Xiaomi account login via QR code.

Finding Your Device ID

Use the mijia-api library to find your device IDs:

from mijiaAPI import mijiaAPI

api = mijiaAPI()
api.login()  # Scan QR code to login
devices = api.get_device_list()
for device in devices:
    print(f"{device['name']}: {device['did']}")

Environment Variables

Usage

CLI Commands

# Check status
uv run python scripts/lamp_cli.py status

# Power control
uv run python scripts/lamp_cli.py on
uv run python scripts/lamp_cli.py off
uv run python scripts/lamp_cli.py toggle

# Brightness (1-100%)
uv run python scripts/lamp_cli.py brightness 50

# Color temperature (2700-6500K)
uv run python scripts/lamp_cli.py temp 4000

# Lighting modes
uv run python scripts/lamp_cli.py mode reading    # Reading mode
uv run python scripts/lamp_cli.py mode computer   # Computer mode
uv run python scripts/lamp_cli.py mode night      # Night reading
uv run python scripts/lamp_cli.py mode antiblue   # Anti-blue light
uv run python scripts/lamp_cli.py mode work       # Work mode
uv run python scripts/lamp_cli.py mode candle     # Candle effect
uv run python scripts/lamp_cli.py mode twinkle    # Twinkle alert

Natural Language Examples

Once integrated with your AI coding agent, you can use natural language:

• "Turn on the light" / "Turn off the light"
• "Make it brighter" / "Make it dimmer"
• "Set brightness to 80%"
• "Switch to reading mode"
• "Warm light please" / "Cool white light"
• "What's the lamp status?"

Integration

Claude Code

Copy the skill to your Claude Code skills directory:

cp -r . ~/.clawdbot/skills/mijia

Other AI Agents

Add the SKILL.md content to your agent's system prompt or tool configuration. The skill provides:

• Device control commands
• Natural language mapping table
• Usage instructions

Extending

You can extend this skill to support more device types. See scripts/lamp_cli.py for an example implementation.

The mijia-api library supports:

• Smart plugs
• Air purifiers
• Vacuum cleaners
• Rice cookers
• Door locks
• And more Mijia devices

Credits

Built on top of mijia-api by Do1e.

License

MIT License