15분 안에 Apple Health 데이터를 잠금 해제하세요: 내보내기, 분석 및 AI에게 무엇이든 물어보세요

Source: Dev.to

Apple Health 데이터 추출 – 문제점

Apple은 Health 데이터에 대한 REST API를 제공하지 않으므로, 데이터를 분석하거나(또는 LLM이 활용하도록) 하려면 기본적으로 두 가지 옵션이 있습니다:

1. HealthKit을 활용하고 데이터를 서버나 클라우드 스토리지(Google Drive, Dropbox, …)로 전송하는 서드파티 앱 사용.
   예시: Auto Health Export(보통 유료).

2. Apple의 내장 내보내기 기능 사용.

   • 내보내는 데 몇 분이 걸릴 수 있고, 중단하기 쉽고, 최신 상태를 유지하려면 매일 반복해야 합니다.

내가 이 프로젝트를 시작한 이유

저는 7년 넘게 Apple Watch를 사용해 왔으며, 수동으로 데이터를 내보내는 번거로움이 늘 거슬렸습니다.

• 몇 년 전, 저는 작은 팀과 함께 Apple Health MCP를 만들었습니다 – 웨어러블 데이터를 LLM에 연결하는 개념 증명 프로젝트였습니다. 성공했고 주목도 받았지만, 사용자가 데이터를 수동으로 내보내야 했던 점이 너무 큰 마찰이었습니다.

• 위의 불편함을 해결하고자 Open Wearables를 만들었습니다 – 오픈‑소스이며 자체 호스팅 가능한 플랫폼으로:

  • 데이터를 자동으로 내보낼 수 있게 해줍니다.
  • 백엔드, 스토리지, 데이터를 탐색할 수 있는 깔끔한 UI를 제공합니다.
  • 데이터를 어떤 LLM 클라이언트와도 연결할 수 있는 AI 레이어(MCP 서버)를 제공합니다.

이 플랫폼은 Apple Health 뿐만 아니라 Garmin, Polar, Whoop, Suunto 등 다양한 생태계를 지원합니다.

대상은 누구인가?

Quick‑Start: Get Your Apple Health Data into Open Wearables (≈ 15 min)

1️⃣ Run an Open Wearables Instance

You have two ways to get the platform up and running.

Option A – Deploy to Railway (easiest)

1. Click the Deploy on Railway button.

2. Wait a couple of minutes – Railway will spin up the backend, frontend, database, Redis, and background workers.

3. An admin account is created on first start‑up:

   email:    admin@admin.com
   password: secret123

Note: Railway is a paid SaaS (no permanent free tier). New users receive a one‑time $5 credit for a 30‑day trial; after that the cheapest plan is $5 / month (Hobby).

Option B – Run Locally + Expose with ngrok

# Clone the repo
git clone https://github.com/the-momentum/open-wearables.git
cd open-wearables

# Start everything with Docker
docker compose up -d

Because the mobile app must reach the backend over the internet, expose the local server:

ngrok http 8000

You’ll get a public HTTPS URL like https://abc123.ngrok-free.app. Keep it handy – you’ll need it later.

Tip: For a stable URL that doesn’t change on restart, use a custom domain:

ngrok http 8000 --domain=your-custom-domain.ngrok-free.app

---

2️⃣ Create a User & Invitation Code

1. Open the Open Wearables dashboard (e.g., https:///dashboard).
2. Log in with the admin credentials (or any account you create).
3. Create a new user for the mobile app.
4. Generate an invitation code for SDK authentication.
5. Copy the code – you’ll paste it into the mobile app next.

---

3️⃣ Get the Open Wearables Mobile App

The app connects to Apple Health on your iPhone and syncs data to your Open Wearables instance.

Option A – Build the App Yourself

# Clone the SDK repo
git clone https://github.com/the-momentum/open_wearables_health_sdk.git
cd open_wearables_health_sdk/example

# Install dependencies
flutter pub get

# Run on a physical iOS device
flutter run

• Open ios/Runner.xcworkspace in Xcode.
• Select your development team.
• Enable the HealthKit capability.
• Important: HealthKit works only on a real device, not the simulator.

Option B – Use a TestFlight Invite

1. Join the Open Wearables Discord.
2. Request a TestFlight beta invitation.
3. Install the pre‑built app (free, App Store release coming soon).

---

4️⃣ Connect the App to Your Backend

1. Open the app on your iPhone.
2. Enter the invitation code you generated earlier.
3. Enter the API URL (e.g., https://api.openwearables.ai or your ngrok URL). Do NOT use the dashboard URL.
4. Grant the requested HealthKit permissions.
5. Tap Sync.

Heads‑up: By default the app syncs your entire history. With 7 years of data (~5 M points) the first sync can take ~20 minutes.

---

5️⃣ Verify the Data in the Dashboard

Return to the Open Wearables dashboard. You should start seeing:

• Steps
• Heart rate
• Sleep
• Workouts
• …and many other time‑series metrics

Explore charts, trends, and raw data – finally you have a place where you can actually work with your Apple Health data.

6️⃣ AI와 함께 데이터와 대화하기 (MCP)

Open Wearables는 MCP (Model‑Connector‑Proxy) 서버를 제공하여, 어떤 LLM 클라이언트(ChatGPT, Claude, Llama, …)를 사용해 웨어러블 데이터를 조회할 수 있습니다.

원본 가이드의 다음 섹션(여기에는 포함되지 않음)에서는 다음을 안내합니다:

• MCP 서버 설정하기.
• 걸음 수, 심박수 추세, 수면 품질 등을 분석하도록 LLM에 요청하는 프롬프트 만들기.
• 내장 UI를 사용해 자신의 데이터와 채팅하기.

---

TL;DR

1. 배포 Open Wearables (Railway 또는 로컬).
2. 사용자 및 초대 코드 생성.
3. 모바일 앱 설치 (직접 빌드하거나 TestFlight).
4. 초대 코드와 API URL 입력 → 동기화.
5. 대시보드에서 데이터 탐색.
6. 선택 사항: MCP 서버를 이용해 LLM에게 건강 관련 질문하기.

이제 Apple Health → Open Wearables → AI‑기반 인사이트의 완전 자동 파이프라인이 구축되었습니다. 즐기세요!

Open Wearables – Quick Overview

Open Wearables는 MCP 서버를 제공하여 건강 데이터를 어떤 LLM 클라이언트(Claude, Cursor 등)와도 연결할 수 있습니다. 자연어로 질문만 하면 됩니다. 예시:

• “지난 주 내 수면은 어땠지?”
• “운동 중 내 심박수 추세를 보여줘.”
• “이번 달과 지난 달의 걸음 수를 비교해줘.”

---

Why You’ll Love It

• All Open Source – 기능이 부족한가요? 직접 만들고, PR을 열거나 레포를 포크하세요. 벤더 락인도 없고 로드맵을 기다릴 필요도 없습니다.
• Vibrant Community – Discord에 100명 이상이 모여 웨어러블 데이터에 열정을 가지고 있습니다. 아이디어를 공유하고, 새벽 2시에도 도움을 받으며, HRV 그래프에 대해 얘기해 보세요. 개발자이든 건강 매니아이든, 여기서 편안함을 느낄 수 있습니다.

---

Get Creative

데이터로 할 수 있는 일은 무궁무진합니다. 인기 예시:

n8n에서 Open Wearables API를 호출하고, 일일 활동을 확인한 뒤, 움직여야 할 때 좋아하는 메신저 앱으로 알림을 보내는 자동화를 구축해 보세요.
(단계별 walkthrough는 제 해커톤 스토리를 참고하세요.)

---

Resources

• [Open Wearables GitHub repository]
• [Discord community]
• [Open Wearables walkthrough video]

---

Call to Action

설정을 15분 이내에 완료했는지 알려 주세요! 우리는 개발자·사용자 경험을 매우 중요하게 생각하므로, 개선 방안에 대한 피드백을 언제든 환영합니다.

즐거운 시간 보내세요!