mcpField
M
mijia

mijia

github.com/hqmanOther0119 installsUpdated 36w ago
Repository

About mijia

A skill for controlling Xiaomi Mijia smart devices through mijiaAPI, with documented lamp commands for status, power, brightness, color temperature, and modes. It is intended for users automating Mijia lamp actions through a command-line script.

Key features

  1. 01Lamp status checks
  2. 02Power on, off, and toggle
  3. 03Brightness adjustment
  4. 04Color temperature setting
  5. 05Reading, computer, and night modes

Use cases

  1. 01Checking a Mijia lamp's status
  2. 02Turning a lamp on or off
  3. 03Changing brightness or color temperature
  4. 04Selecting a predefined lamp mode

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hqman/my-skills --skill mijia

After installing, type/mijiain Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
pyproject.toml
scripts/
lamp_cli.py

Details

From the project README

Mijia Smart Home Control

Control Xiaomi Mijia smart devices via the mijiaAPI.

Setup

Before using this skill, you need to:

  1. Install dependencies:
cd /path/to/mijia-skill
uv sync
  1. Set your device ID as an environment variable:
export MIJIA_LAMP_DID="your_device_id"
  1. First run will prompt for Xiaomi account login via QR code.

Finding Device IDs

To find your device IDs, use the mijia-api library:

from mijiaAPI import mijiaAPI
api = mijiaAPI()
api.login()
devices = api.get_device_list()
for d in devices:
    print(f"{d['name']}: {d['did']}")

How to Use

Skill path: ~/.clawdbot/skills/mijia

Lamp Control Commands
# Navigate to skill directory
cd ~/.claude/skills/mijia

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

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

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

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

# Set mode
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 Understanding

When the user says the following, execute the corresponding command:

User SaysCommand
Turn on the light / open lampscripts/lamp_cli.py on
Turn off the light / close lampscripts/lamp_cli.py off
Toggle the lightscripts/lamp_cli.py toggle
Brighter / more brightCheck status first, then increase by 20-30%
Dimmer / less brightCheck status first, then decrease by 20-30%
Full brightness / maximumscripts/lamp_cli.py brightness 100
Minimum brightnessscripts/lamp_cli.py brightness 1
Warm lightscripts/lamp_cli.py temp 2700
Cool light / white lightscripts/lamp_cli.py temp 6500
Reading modescripts/lamp_cli.py mode reading
Computer modescripts/lamp_cli.py mode computer
Night modescripts/lamp_cli.py mode night
Lamp status / what's the light statusscripts/lamp_cli.py status

Before Executing

  1. Navigate to skill directory: cd ~/.clawdbot/skills/mijia
  2. Ensure MIJIA_LAMP_DID environment variable is set
  3. Run with uv: uv run python scripts/lamp_cli.py <command>
  4. Report the result to the user after execution

Comments

Markdown supported