mijiaAPI

米家 API，可以使用代码、CLI、MCP 直接控制米家设备。

🎉 v4.0.0 版本已支持 MCP，详见 MCP 使用文档
🎉 v4.1.0 版本已支持 Agent Skill，详见 Agent Skill 使用文档

📖 完整文档请见 mijia-api.do1e.com

安装

要求 Python >= 3.10

pip install mijiaAPI
# Or `uv add mijiaAPI` for uv users

其他安装方式（源码安装、AUR）请参考文档。

快速开始

from mijiaAPI import mijiaAPI, mijiaDevice

# 初始化并扫码登录（认证文件默认保存在 ~/.config/mijia-api/auth.json）
api = mijiaAPI()
api.login()

# 通过设备名称控制设备（推荐）
device = mijiaDevice(api, dev_name="我的台灯")
device.on = True              # 打开设备
device.brightness = 60        # 设置亮度为 60%

# 查看设备支持的所有属性和动作
print(device)

CLI 用法：

mijiaAPI login                          # 扫码登录
mijiaAPI -l                             # 列出所有设备
mijiaAPI set --dev_name "台灯" --prop_name "brightness" --value 60

MCP 用法：

执行 uvx mijiaAPI login -p /path/to/auth.json 登录后，在 MCP 客户端配置中添加以下内容即可接入米家：

{
  "mcpServers": {
    "mijia-api": {
      "command": "uvx",
      "args": ["mijiaAPI", "mcp", "-p", "/path/to/auth.json"]
    }
  }
}

更多用法（API 基础调用、MCP Server、CLI 完整参数、最佳实践等）请查阅完整文档。

致谢

开源许可

本项目采用 GPL-3.0 开源许可证。

请注意：GPL-3.0 是具有“强传染性”的开源许可证。
如果您在您的项目中使用、修改或分发本项目的代码（包括作为库依赖），您的整个项目也必须以 GPL-3.0 或兼容许可证开源发布。

免责声明

本项目仅供学习交流使用，不得用于商业用途，如有侵权请联系删除
用户使用本项目所产生的任何后果，需自行承担风险
开发者不对使用本项目产生的任何直接或间接损失负责

Metadata

Release files for mijiaAPI 4.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mijiaAPI 4.3.0
File	Size	Uploaded
mijiaapi-4.3.0.tar.gz	145.2 kB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mijiaAPI 4.3.0
File	Interpreter	ABI	Platform	Reset
mijiaapi-4.3.0-py3-none-any.whl 41.5 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 186.7 kB

Release files / mijiaapi-4.3.0.tar.gz

Download URL	mijiaapi-4.3.0.tar.gz
Size	145.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`0c1df164262f0dfd6f504414d988f3fe139a59245833749a102660a6a378bb62`
BLAKE2b-256 checksum How to use checksums	`0c233e6302fb54ac27a9587df71682c0ec756a7a5866e55b8963ef2b0032ceb8`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / mijiaapi-4.3.0-py3-none-any.whl

Download URL	mijiaapi-4.3.0-py3-none-any.whl
Size	41.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d76ef7cb809be35a7bdbf257d3b05634212320ddb9c3201c441a38be896a90c5`
BLAKE2b-256 checksum How to use checksums	`c5329d4c89b6a02fb18d2e85401747652b1a67b7a8aa104b8690e77ba3afc62e`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`