How to Build and Configure Xiaomi Mi Cube Smart Cube: A Complete Guide to 2026

The Xiaomi Mi Cube is a compact device that turns ordinary gestures into commands to control a smart home, which can turn on lights, run scripts or control multimedia in one motion, but many users face difficulties during the assembly and initial setup phase, and in this article, we will learn how to properly assemble the cube, connect it to the Mi Home system and avoid typical errors.

The Mi Cube design is simple, but has its own nuances: improper positioning of magnetic elements or errors when synchronizing with the application can make the device useless. We’ll take a closer look at every step from unpacking to integration with other Xiaomi gadgets, including compatibility with Mi Home, Google Assistant and Apple HomeKit (via workarounds). Particular attention will be paid to hidden functions of the cube that are not described in the official instructions, for example, setting up a double-press or using as a remote for Mi TVs TV.

What is included in the kit Xiaomi Mi Cube and how to check the configuration

Before assembly, make sure the box has all the necessary elements.The standard Mi Cube kit (MJTD01YL or MJTD02YL models) includes:

• 📦 The main body of the cube (upper and lower parts)
• 🧲 Magnetic holder (sometimes attached to the housing)
• 🔋 Battery CR2032 (already installed or in a separate bag)
• 📄 Short instructions in several languages (without Russian)
• 🔘 Reset button (embedded in case, not removable)

If you bought the cube separately (like on AliExpress or in unofficial stores), check for seals on the box.Fake devices often come without a magnetic holder or with a low-quality battery, resulting in a quick discharge.The original Mi Cube has:

• 🔍 Mi logo on top panel (engraved, not sticker)
• 📌 Serial number on battery sticker
• 🎨 Matte coating of the case (glossy plastic - a sign of counterfeit)

Important: If you don't have a CR2032 battery, don't use cheap ones, they can leak and damage contacts. Recommended brands are Duracell, Energizer or Panasonic.

Step-by-step assembling the cube: from battery to magnetic fastening

The Mi Cube takes no more than 5 minutes to assemble, but requires careful handling.

1. Install the battery, flip the bottom of the cube up. Press the latch of the battery compartment (which is next to the reset button) and carefully remove the lid. Put the battery CR2032 upside down (it has a marking on it). Close the lid until you click. 💡 If the lid doesn't close, check if the battery is skewed. Sometimes the contacts are bent during transportation, they can be straighten neatly with a needle.
2. Stick the magnetic holder to any flat surface (table, wall, torzer). The optimal height is 70-100 cm from the floor to make the cube easy to rotate. The surface should be clean and dry. Do not stick the holder on metal or thick wooden surfaces - this will worsen the operation of the sensors.
3. Install the cube on the holder. When properly assembled, it should: 🔄 Easy to rotate around its axis 🔊 Produce a short beep when pressed on any edge 💡 Blink with a white LED (below the top panel)

If the cube does not respond to the action, try:

1. Remove and re-insert the battery.
2. Press the reset button (hold 5 seconds until the LED flashes).
3. Check if the LED is closed with a sticker (sometimes it interferes with the sensor).

Connect Xiaomi Mi Cube to the Mi Home app

Without a connection to the Mi Home, the cube will only work as a toy.

1. Install the app Download Mi Home from Google Play or App Store. Sign up or sign in to an existing Xiaomi account.
2. Add Device In App Go to Profile → Settings → Add Device. Select Smart Home, then Sensors, and find Mi Cube (or Xiaomi Magic Cube). Click Add.
3. Keep the cube 10 to 20 cm away from your smartphone. Press and hold any face of the cube for 3 to 5 seconds until the LED blinks quickly. The app will show a message saying "Device found." Confirm the connection.

If the cube is not:

• 📶 Make sure your smartphone is Bluetooth enabled and geolocated.
• 🔄 Reboot the Mi Home app.
• 📵 Check if the antivirus is blocking Bluetooth access (especially for Avast or Kaspersky).

Set up gestures and commands in Mi Home

By default, the Mi Cube supports 6 basic gestures, but you can reconfigure them or add them to them.

1. In Mi Home, select your cube from the list of devices.
2. Go to Settings. → Gesture management.
3. Click on any gesture (e.g., “Clockwork Rotation”) and select the action: 💡 Light Control (Yeelight, Philips Hue) 🔊 Media Control (Mi TV, Xiaomi Soundbar) 🌡️ Run scenarios (e.g., “Leave Home”) 🔌 Socket Control (Xiaomi Smart Plug)

Standard gestures and their factory settings:

For advanced users, you can create chains of commands in Mi Home, for example, one tap on a cube will turn on the light, run a playlist on the Mi TV and close the curtains.

1. Go to Automation → Scenarios.
2. Create a new script with the trigger “Gest Mi Cube”.
3. Add a few actions and save.

💡

The Mi Cube supports up to 12 custom gestures if you use third-party firmware (e.g., through Home Assistant), however, this requires unlocking the device and may be unwarranted.

Integration with Google Assistant and Apple HomeKit

Officially, Mi Cube doesn’t support Google Assistant or HomeKit, but there are workarounds:

Connecting to Google Assistant

1. In Mi Home, link your Xiaomi account to Google (Profile → Settings → Accounts → Google).
2. Open Google Home, click Add → Device → Set up your device.
3. Select Xiaomi from the list of brands and log in.
4. Once synchronized, the cube will appear in Google Home as "Unidentified Device" and can be added to a room and voice controlled (e.g., "OK Google, turn on the Kitchen through the Cube script").

Connect to Apple HomeKit (via Home Assistant)

Integration with HomeKit will require:

• 🖥️ Installed Home Assistant (on Raspberry Pi or server).
• 🔌 Xiaomi Mi Home Integration plug-in.
• 📱 HomeKit Controller for Home Assistant.

Instructions:

1. In Home Assistant, add Mi Home integration and log in.
2. Find the Mi Cube in the list of devices and add it to the configuration.
3. In the configuration.yaml file, write:

xioami_aqara:




gateways:




- key: YOUR_MI_HOME_KEY




mac: YOUR_GATEWAY_MAC




host: YOUR_GATEWAY_IP





homekit:




- name: HomeKit Bridge




port: 51827




filter:




include_entities:




- sensor.mi_cube_action

1. Reboot Home Assistant and add a bridge to Apple Home via QR- code.

💡

To simplify the configuration of HomeKit, you can use ready-made Home Assistant images with pre-installed integrations (for example, Home Assistant OS with the addition of HACS).

Common mistakes and their solutions

Even after successful build, users face challenges, and here are the most common ones and ways to fix them:

• 🔋 Cube discharges quickly Reason: cheap battery or constant sync with Mi Home. Solution: Replace battery with Duracell or Energizer. In Mi Home settings, disable Cloud Sync for the cube. Reduce active scripts.
• 🔄 Gestures are delayed Cause: weak Bluetooth signal or network congestion Solution: Make sure there are no obstacles between the cube and the Xiaomi Gateway. Reboot the gateway (turn off power for 30 seconds). Update the cube and gateway firmware.
• 📵 The cube doesn't respond to rotation Cause: improperly mounted on the holder or sensor damage Solution: Check that the cube sits tightly on the magnetic holder. Wipe the contacts on the bottom of the cube with alcohol. Reset (reset button 10 seconds).

⚠️ Warning: If the cube has stopped responding to any action, do not disassemble it yourself - there are no service elements inside, and an attempt to repair will deprive you of warranty. Contact Xiaomi Service Center or replace the device under warranty (period - 12 months from the date of purchase).

Hidden features and life hacks for Xiaomi Mi Cube

In addition to the standard gestures, the Mi Cube has several hidden features:

• 🎮 Used as a gamepad, Tasker (Android) or Shortcuts (iOS) can assign cube gestures to control games, such as spinning to jump, double tap to shoot, and require the AutoNotification plugin and the HTTP- customization of Mi Home API requests.
• 📱 Smartphone control In the Mi Home, you can link cube gestures to actions on your phone: Single tap to turn on the flashlight. Double tap to open the camera. Shake to turn on In the Plane mode. To do this, select "Phone Control" in the cube settings and assign actions.
• 🔊 Voice prompts If you connect the cube to the Xiaomi AI Speaker, it will voice the executed commands (for example, “Lights on in the living room”). To activate, go to Cube Settings → Voice notifications.

For automation enthusiasts, Mi Cube can be integrated with IFTTT (via Mi Home) and create action chains with other services, such as:

• Shake the cube → send SMS via IFTTT.
• Spin → posting a post on Twitter.
• Double tap → launch of Spotify playlist.

💡

With the help of Home Assistant and the Xiaomi Miio plugin, you can expand the functionality of the cube to 20+ custom gestures, including combinations (for example, “spin + press”).

FAQ: Frequent questions about Xiaomi Mi Cube