---
id: micloud
version: "0.6"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# micloud — Xiaomi cloud connect library

License: permissive · Maintenance: abandoned · Downloads: 149.8K/mo

## What it is and what it does

MiCloud is a Python library for authenticating with Xiaomi cloud accounts and fetching device information. It provides a simple interface to log in with credentials, retrieve authentication tokens, and list connected devices from the Xiaomi cloud service. The library can be used both as a Python module in code and as a command-line tool.

The package has no runtime dependencies and offers basic functionality: login, token retrieval, and device enumeration with optional JSON export. However, it is abandoned—the last commit was 2022-12-08—meaning it has not been updated to track potential changes in Xiaomi's cloud API or to maintain compatibility with modern Python versions.

Use it for:

- Retrieve a list of Xiaomi IoT devices associated with a cloud account for inventory or monitoring purposes
- Obtain a cloud service token for authenticating subsequent requests to Xiaomi device APIs
- Export device information to JSON for integration into home automation or device management systems
- Query Xiaomi cloud from a terminal script using the command-line interface with username and country parameters

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Logs into Xiaomi cloud accounts and retrieves device information and authentication tokens from the Xiaomi cloud service.

No. The package is abandoned and has not been updated since 2022-12-08. Without active maintenance, it is at high risk of breaking against current Xiaomi cloud APIs, and its Python version support is undocumented. High install friction compounds the risk. Only install if you are certain it works with your specific Xiaomi cloud environment and can maintain a local fork if needed.

## Install

pip install micloud
uv add micloud
poetry add micloud

## Installing micloud

Before you install: High install friction reported. Package is abandoned as of 2022-12-08 with no updates since its latest release, raising questions about compatibility with current Xiaomi cloud APIs and Python versions.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it legally safe to incorporate into most projects.

Quickstart:

pip install micloud

from micloud import MiCloud

mc = MiCloud("USERNAME", "PASSWORD")
mc.login()
devices = mc.get_devices(country="de")
token = mc.get_token()

Python version support is unspecified; Xiaomi cloud API may have changed since last release in 2022, potentially breaking authentication.

Verify before relying:

- Whether the package still authenticates successfully against current Xiaomi cloud endpoints
- Exact Python version compatibility not documented in the fact sheet
- Whether high install friction stems from missing dependencies or packaging issues

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 149.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

xiaomi cloud login, xiaomi device list api, xiaomi cloud authentication, xiaomi account integration, xiaomi iot device retrieval, xiaomi cloud token, xiaomi device management, xiaomi-iot, cloud-api, abandoned

[View on SkillFed](https://skillfed.io/packages/micloud) · [View on PyPI](https://pypi.org/project/micloud/)