About
SmartThings Find is an integration that brings Samsung SmartThings Find devices into Home Assistant with their location and battery. It covers phones, tablets, watches, earbuds and SmartTags, and it can make a device ring or ask it for its current position. Each device gets a location tracker, plus a connected sensor, status sensors for last update, network and last request result, and buttons for ringing, stopping the ring and updating the location. Location updates run in a passive mode that reads the last position Samsung holds, or an active mode that asks the device and uses its battery; a per-device switch overrides the defaults. A maximum position age drops old positions so a person entity falls back to its other trackers. It talks to Samsung's cloud and is set up in the UI by signing in with a Samsung account or a browser cookie header.
Automatic summary of the README and code of fapgomes/ha-smartthings-find. Something wrong, or are you the maintainer and want your own text here? Get in touch
Shows in Vulpo
Quick Toggle card, Button card, Chart card, Apple Watch, Control Center.Supports
- Uses the vendor's cloudNeeds an internet connection and an account with the vendor.
- From the MarketplaceInstalled through the Marketplace, formerly HACS.
- Actively maintainedIts author released or pushed a change in the last six months.
Provides
- Switches
- Sensors
- Presence
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Samsung Account
- Address starting with ms-app://The ms-app://… address copied from the Network tab.
- Update interval (seconds)
- Session keepalive interval (seconds)
- Default SmartTag modePassive: read the last position Samsung has (no extra battery use). Active: ask the device for its position automatically, at most once per automatic update interval (fresher, uses the device's battery). Change it per device with its *Automatic location update* switch.
- Default mode for phones, watches and earbudsPassive: read the last position Samsung has (no extra battery use). Active: ask the device for its position automatically, at most once per automatic update interval (fresher, uses the device's battery). Change it per device with its *Automatic location update* switch.
- Automatic update interval (seconds)Minimum time between automatic location requests to the same device. Requests are only sent on updates, so the real interval is rounded up to the next update.
- Maximum position age (minutes, 0 = no limit)After this, the tracker stops reporting the old position (state unknown), so person falls back to its other trackers.
Cookie header
- Cookie headerThe complete Cookie header of the chkLogin.do request.
- Update interval (seconds)
- Session keepalive interval (seconds)
- Default SmartTag modePassive: read the last position Samsung has (no extra battery use). Active: ask the device for its position automatically, at most once per automatic update interval (fresher, uses the device's battery). Change it per device with its *Automatic location update* switch.
- Default mode for phones, watches and earbudsPassive: read the last position Samsung has (no extra battery use). Active: ask the device for its position automatically, at most once per automatic update interval (fresher, uses the device's battery). Change it per device with its *Automatic location update* switch.
- Automatic update interval (seconds)Minimum time between automatic location requests to the same device. Requests are only sent on updates, so the real interval is rounded up to the next update.
- Maximum position age (minutes, 0 = no limit)After this, the tracker stops reporting the old position (state unknown), so person falls back to its other trackers.
After setup
- New Cookie header (leave empty to keep the current one)
- Update interval (seconds)
- Session keepalive interval (seconds)
- Default SmartTag mode
- Default mode for phones, watches and earbuds
- Automatic update interval (seconds)Minimum time between automatic location requests to the same device. Requests are only sent on updates, so the real interval is rounded up to the next update.
- Maximum position age (minutes, 0 = no limit)After this, the tracker stops reporting the old position (state unknown), so person falls back to its other trackers.
Texts from the code of fapgomes/ha-smartthings-find.
Entities
- Binary sensorsConnected
- ButtonsRing, Stop ring, Update location
- SensorsLast update, Network, Last request result
- SwitchesAutomatic location update
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
Brings the location and battery of the Samsung devices registered in SmartThings Find into Home Assistant: phones, tablets, watches, earbuds and SmartTags. It can also make them ring and ask them for their current position.
Information
- Installs
- 330 sharing analytics
- GitHub stars
- 3
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v2.3.3,
- Category
- Hubs and protocols, Smart home hubs
- Kind
- Marketplace integration
- Brand
- SmartThings
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
smartthings_find- Issues
- Report an issue












