Map your smart home's Thread mesh, spot weak links, configure supported Matter settings, and monitor battery accessories. Optional AI diagnostics.
Thread Doctor maps and helps diagnose the Thread mesh used by your Matter accessories paired in the Home app.
When devices go unresponsive, respond slowly, or keep dropping off the network, Thread Doctor helps you see what is happening: routers, end devices, Border Routers, signal quality, battery levels, and possible weak points in your mesh.
It reads supported Matter and Thread diagnostic data directly from your paired accessories and lets you change supported Matter device settings. Changes happen only when you explicitly apply them. Available values and settings depend on each accessory, firmware version, and platform support.
WHAT IT HELPS ANSWER
• Why do my Matter accessories show “No Response”?
• Which device may be a weak point in my Thread mesh?
• Where should I add another Thread router?
• Which battery-powered accessories need attention?
• Why did my Matter clock lose the time after a power cut?
FREE FEATURES
• Mesh graph with routers, child devices, Border Routers, signal values, link quality, and router-child relationships.
• Device details for supported Matter and Thread attributes, including RSSI, LQI, RLOC16, routes, neighbors, Leader Router ID, sleep behavior, battery level, error rate, uptime, and more.
• Force Sync (time) — set a Matter accessory's clock; shows device time, drift, and time source.
• Identify — ask an accessory to blink its light so you can physically find it.
• Possible weak-point detection based on topology data available during the scan.
• Thread Leader identification.
• Battery monitoring and filtering.
• Separate lists and detail cards for HomeKit-only accessories, Matter-over-Wi-Fi devices, and Thread devices that hide diagnostics.
• Self-reported device faults — radio, network, and hardware faults read from each accessory's Matter General Diagnostics cluster.
• Matter device configuration — change supported settings such as power-on behavior, transition times, sensor delays, thermostat controls, and more.
PRO FEATURES
• AI Diagnose
Use your own third-party LLM API key to analyze a structured mesh snapshot. Preview the outbound payload before sending; analysis starts only when you tap Analyze.
• Scan history
Browse past scans, compare snapshots, and review previous network states.
• Snapshot export
Share the raw mesh as JSON for troubleshooting, research, social posts, or your own scripts.
One-time unlock. No subscription.
PRIVACY
Thread Doctor is designed to work locally.
• No backend, analytics, telemetry, accounts, or third-party SDKs.
• Pro unlock is handled through the standard in-app purchase system.
• Your LLM API key is stored only on-device in the system Keychain.
• Matter diagnostics and configuration changes use native APIs. Settings change only when you explicitly apply them.
• Optional AI Diagnose sends data only after you preview the payload and tap Analyze.
REQUIREMENTS
• iOS 18 or later
• Matter accessories paired in the Home app
• Wi-Fi connection to the same network as your Border Routers
• Optional AI Diagnose requires your own third-party LLM API key
NOT A WI-FI NETWORK SCANNER
Thread Doctor does not scan Wi-Fi networks. It reads supported Matter and Thread diagnostic information from paired smart home accessories.
Thread Doctor is an independent indie project. It is not affiliated with or endorsed by any platform provider, standards organization, or accessory manufacturer.
Full data-flow documentation:
https://threaddoctor.app/privacy
Terms of Use:
https://www.apple.com/legal/internet-services/itunes/dev/stdeula
Thread Doctor is the most comprehensive app for visualize, monitoring and troubleshooting your Thread network. The app is extremely impressive with a very detailed graphic display of your thread mesh network. Matter over Thread devices show even more information. Using it takes the guesswork out of what’s actually happening. It’s like coming in from the dark. Way more useful than the Eve app.
Developer Response
❤️
Almost perfect
James28475859
This app is great for diagnosing or even just understanding how you Thread mesh network is behaving. One thing that would bump this up to near perfect would be if you could nickname child devices that are HomeKit-Matter. Right now you can see them and their parent, but it shows up in the diagram like “Child 0x1049” for example. Since these seem to be static (S/N or MAC?) it would be great if the user could just manually add an override nickname. And maybe let you tap it to see that it’s non-matter or HomeKit-thread etc. Even better would be if the app could grab the name from HomeKit automatically like the Eve app does for Thread view. But a manual nickname is good enough.
This App is a Must Have
quantumonion
This app provides sooo much more information versus Apple’s dns-sd utility. While dns-sd is useful, this app goes well beyond to show ACTIONABLE information in the form of retransmissions, error rates, reboots, etc.Exporting Thread Doctor’s JSON scan data and feeding to Claude (or your favorite LLM) gives the LLM a lot to work with, especially if you’ve documented your network Mac/IPs/etc in a form the LLM can digest (I use Markdown with standardized frontmatter managed by Obsidian Notes, but any similar source of truth would be fine).Thread Doctor works fine on macOS as well (I’m running it under macOS 27 beta 4 which bodes well for when Golden Gate is released.Kudos to the author. This is a wonderful tool.
Developer Response
❤️
A must for all Thread networks
Phizbam
So far, this is the most comprehensive app I’ve found for viewing and monitoring Thread networks. Considering that Apple (HomeKit) basically hides many things their thread network rather than expose it, I find this app pretty impressive. I love the last update — keep them coming and keep up the good work.
Developer Response
❤️
• Apple Intelligence on iOS 27: Private Cloud Compute, no API key
• Separate topology views for multiple Thread networks
• Updated AI picker
• UI/UX fixes
Version 1.18
The developer, Konstantin Rafikov, indicated that the app’s privacy practices may include handling of data as described below. For more information, see the developer’s privacy policy .
Data Not Collected
The developer does not collect any data from this app.
Privacy practices may vary, for example, based on the features you use or your age. Learn More
The developer indicated that this app supports the following accessibility features. Learn More