the-momentum/open-wearables

What is it?

Key features

• 01Unified REST API that normalizes data from cloud and SDK-based wearable providers.
• 02Built-in MCP server for querying wearable data from Claude, Cursor and other MCP clients.
• 03Webhooks with event filters, signature verification and delivery inspection.
• 04Apple Health XML export import, including large files via S3 multipart upload.
• 05Native iOS, Android, Flutter and React Native SDKs for on-device health data sync.
• 06Docker Compose setup with a developer portal for API keys, users and sync monitoring.

Use cases

• Grounding an AI health coach in users' real sleep and workout data.
• Aggregating patient or client wearable data for a healthcare or wellness app.
• Collecting standardized multi-device health data for a research project.
• Self-hosting a personal wearable data store and querying it through an MCP client.

Quick start

1. 1

   Clone the repository

   git clone https://github.com/the-momentum/open-wearables.git
2. 2

   Enter the project directory

   cd open-wearables
3. 3

   Copy the backend environment file

   cp ./backend/config/.env.example ./backend/config/.env
4. 4

   Copy the frontend environment file

   cp ./frontend/.env.example ./frontend/.env
5. 5

   Start the application with Docker Compose

   docker compose up -d

Things to know

• !Early-stage project; APIs may change before version 1.0.
• !The default Docker Compose setup is for development; production needs pinned official images.
• !Requires self-hosting and Docker setup to run.

In collections

Topics

FAQ

What is open-wearables?

Self-hosted platform that unifies wearable health data from many providers behind one normalized API, with webhooks and an MCP server for AI tools. Open Wearables is an open-source platform that connects to data from many wearable devices and fitness services, including Garmin, Oura, Whoop, Suunto, Polar, Strava, Fitbit and Apple Health, and exposes it through a single REST API. Developers no longer need to build separate OAuth flows, data mappings and sync logic for each provider, since everything is returned in one normalized data model covering activity, sleep, workouts and time series such as heart rate and HRV.

Is open-wearables free to use? What license does it have?

open-wearables is open source under the MIT license. Check the license terms before using it in commercial products.

Is open-wearables still maintained?

Actively maintained. The last commit to open-wearables was on Oct 23, 2026.

What can I use open-wearables for?

Grounding an AI health coach in users' real sleep and workout data. Aggregating patient or client wearable data for a healthcare or wellness app. Collecting standardized multi-device health data for a research project. Self-hosting a personal wearable data store and querying it through an MCP client.

How do I install open-wearables?

Clone the repository: git clone https://github.com/the-momentum/open-wearables.git Enter the project directory: cd open-wearables Copy the backend environment file: cp ./backend/config/.env.example ./backend/config/.env Copy the frontend environment file: cp ./frontend/.env.example ./frontend/.env Start the application with Docker Compose: docker compose up -d

Where can I get open-wearables?

The source code and installation instructions are on GitHub: https://github.com/the-momentum/open-wearables