tineco for Home Assistant (Marketplace integration)

Installs: 185 sharing analytics
GitHub stars: 19
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v2.4.3, October 8, 2026
Category: Appliances and cleaning, Cleaning
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: tineco
Source: github.com/wheeller123/Tineco-Integration
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Tineco is a custom integration that connects Tineco vacuum cleaners to Home Assistant through the vendor's cloud. It adds sensors for battery, vacuum status, model, firmware version, and the waste and fresh water tank states. Binary sensors report online and charging status, and switches cover power, sound, water-only mode, and a floor brush light on models that have one. Select controls set sound volume, suction power, and spray volume, and the water mode selects are disabled while water mode is off. Both global regions and China are supported, and the update interval and server region can be changed in the options. It was developed against the S7 Flashdry, with other models working based on community feedback, and setup is done in the UI.

Automatic summary of the README and code of wheeller123/Tineco-Integration. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Tineco IoT Account

Email or Phone Number
Password
Region (Default: IE)

Device Verification

Verification Code

After setup

Update interval (seconds)How often to check device status. Lower values provide faster updates but may increase API usage. Default: 60 seconds.
Server RegionThe server region used for API requests.

Texts from the code of wheeller123/Tineco-Integration.

Entities

Binary sensorsOnline, Charging
SensorsDevice Status, Firmware Version, API Version, Model, Battery, Vacuum Status, Waste Water Tank Status
SwitchesPower

From the README

Control your Tineco smart devices through Home Assistant using this custom integration.
Current version: 2.4.3 — supports global (IE, US, etc.) and China (CN) regions. Developed against the S7 Flashdry; other models (incl. Floor One S5 / S5 Pro / S5 Combo) work with community feedback.
Device Discovery: Automatically discovers Tineco devices in your account
Sensor Entities:
Firmware version
API version
Device model
Battery level
Vacuum status (idle, in_operation, self_cleaning, etc.)
Waste water tank status (clean/full)
Fresh water tank status (empty/full)
Switch Controls:
Sound: Enabled (mute/unmute)
Water Mode: Enabled (enable/disable water-only mode)