Skip to main content

​
Overview

Apple Health, Samsung Health, and Google Health Connect keep your health data locked on the device - none of them offer a REST API to access it remotely. The Open Wearables mobile app bridges that gap. Install it, enter an invitation code, and on-device health data starts flowing to your Open Wearables instance automatically. Whether you’re into self-tracking and want to own your health data, or you’re a coach or trainer monitoring athletes and clients across Apple, Google, and Samsung devices - the app gives you a simple way to get data into Open Wearables without building anything.
The app is currently in beta. Join our Discord and ask for a TestFlight (iOS) or APK (Android) invitation. Public App Store and Play Store releases are coming soon!
Samsung Health on Android requires Developer Mode. Samsung Health only allows data access to apps registered through Samsung’s official partnership program. Since the Open Wearables app is not a registered Samsung partner, you need to enable Developer Mode in the Samsung Health app for it to work. This does not apply if you use Health Connect as your data source.

​
How it works

1

Get an invitation code

In the dashboard, open a user’s profile and click Connect Mobile App. You’ll get both the API URL and a single-use Invitation Code to enter in the app. For coaches - one code per athlete/client.
2

Install and connect

Open the app, paste the API URL and invitation code, and tap Connect.
3

Grant health permissions

The app requests access to health data (steps, heart rate, sleep, workouts, etc.). On Android, the user also chooses between Health Connect and Samsung Health.
4

Automatic sync

Once connected, the app syncs health data in the background. Users can also tap Sync Now at any time.

​
See it in action

​
1. Creating an invitation code in the dashboard

First, the instance admin creates a user and generates an invitation code:

​
2. Connecting with the mobile app

Enter the invitation code and API URL, then the app connects to the health data source and starts syncing:
Make sure to enter the API URL (e.g. https://api.openwearables.ai), not the dashboard URL (e.g. https://app.openwearables.ai).

​
3. Browsing data in the dashboard

Once synced, health data is available in the Open Wearables dashboard:

​
4. Talking to data with AI (MCP)

Use the Open Wearables MCP server to chat with health data using AI tools like Claude:

​
5. Accessing data via the API

Synced data is also available programmatically via the REST API.

​
Troubleshooting

  • Check that the invitation code hasn’t been used already
  • Make sure you’re entering the API URL, not the dashboard URL
  • Verify the Open Wearables instance is running and reachable from your phone
  • Confirm health permissions were granted (iOS: Settings > Privacy > Health; Android: Settings > Health Connect)
  • Make sure there’s actual health data on the device
  • Try tapping Sync Now to force an immediate sync
  • Check the Logs tab in the app for errors
Make sure you’re running on a physical device - HealthKit is not available in the iOS Simulator.
  • Health Connect: must be installed from Play Store (pre-installed on Android 14+)
  • Samsung Health: only available on Samsung devices

​
For developers

Want to build your own app with the Open Wearables SDK? Check out the example app guides:

Flutter Example App

Build and run the Flutter example app from source.

React Native Example App

Build and run the React Native example app from source.