MCP server v1.0 · live on iOS & macOS

Your iPhone knows
everything about you.
Now your agents do too.

Soma streams Apple Health and location data from iPhone to Mac, where any AI agent can query it locally over MCP.

No cloud. No exports. No prompts that start with “I’m in downtown Raleigh, I’ve been walking around all afternoon…”

Built on Apple HealthKit + CloudKit · fully on-deviceSpeaks MCP — Claude, ChatGPT, Cursor, OpenClaw, Hermes
12:21 5G35
SETTINGS
Soma Control
Manage your device pairing, data retention, and MCP configuration.
Paired Device
StatusNot Paired
DeviceNone
Last Syncnot started
CloudKit Zone
Health Data
Choose which categories Soma reads from the Health app.
Activity & Sleep
Heart & Breathing
Pair
Permissions
Settings

Speaks MCP. Works with whichever agent you already have.

Claude
OpenClaw
Hermes Agent
ChatGPT
Cursor

Currently available for iPhone + Mac. Windows support in development.

01 · The problem

You tell your agent what it should already know.

Your iPhone tracks heart rate, sleep stages, step count, workout history, GPS — continuously, passively, all day.

But none of that context reaches your agents. Every prompt starts at zero. You become the manual bridge between your sensors and your model.

02 · The context gap

From search engine to assistant.

Without Soma
I’m in downtown Raleigh near Fayetteville St, I’ve been walking around all afternoon, looking for dinner, preferably something Asian, not too expensive. I’m pretty tired so close by is better.
I found a few Asian restaurants near Fayetteville St:
1. City Market Sushi — 0.4 mi
2. Garland — 0.3 mi
3. Bida Manda — 0.5 mi
Want me to check wait times?
Agent + Soma MCP
Find me dinner.
→ query_location() · Raleigh, NC
→ query_health() · 14k steps · energy: low
→ query_history() · prefers Asian Thursdays
You’re on Fayetteville St, you’ve walked 14k steps — probably tired. City Market Sushi is a 3-min walk, no wait, fits your usual price range. Directions sent.
[ waiting for user input ]
Proactive nudge · 3:42pm
You’re passing a UPS Store — your Amazon return has been in your bag since Tuesday.
Also, your HRV is down 15% this week. I’d swap tonight’s strength session for mobility.
03 · Architecture

An always-on pipeline. Local end to end.

01
Soma · iPhone

Reads from HealthKit and Core Location in the background. Heart rate, sleep, steps, workouts, GPS — flowing continuously.

$4.99/mo
02
iCloud Sync

Data syncs passively through your personal iCloud. Zero configuration, zero servers, zero third parties.

E2E encrypted
03
Mac Companion

A lightweight menubar app that receives your data and runs the local MCP server. Always running, never in the way.

Free
04
Your agent

Claude, OpenClaw, Hermes, ChatGPT, Cursor — any MCP-compatible client queries via standard tool calls.

localhost only
04 · Privacy

Your health data never touches our servers. Ever.

Your iCloud, your data.

Soma syncs through your personal iCloud account using CloudKit private database zones. We cannot access, read, or query your data. It's architecturally impossible — not just policy.

Local-only processing.

The MCP server runs strictly on your Mac. Your agent queries data over localhost. Nothing leaves your machine unless you explicitly send it somewhere.

No account required.

Soma has no accounts, no logins, no profiles. There's nothing to breach because we don't collect anything.

Open-source transparency.

The dashboard and skill templates are open source. Inspect the code. Build your own clients. Audit anything you want.

05 · Data spec

What Soma exposes to your agents.

33 data types across 6 categories. All queryable on your Mac through a single MCP interface.

iPhoneApple Watch
Health Metrics
Heart rateResting HRHRVSpO₂Respiratory rateBody tempBlood pressure
Activity
StepsDistanceFlights climbedActive energyExercise minsStand hoursActivity type
Sleep
Total durationBedtime / WakeSleep stagesSleep score
Workouts
Workout typeDurationCaloriesAvg / Max HRRoute (GPS)Pace & speed
Location
GPS coordsSpeedAltitudeHeadingLocation historyGeofence events
Body
WeightBody fat %BMI
07 · Open dashboard

Own your telemetry.

Soma ships with a free, open-source health dashboard you can run locally. Sleep patterns, activity trends, HRV, location history — all from data that never leaves your machine.

Fork it. Customize it. Build your own panels.

View on GitHub
localhost:3000
Health Overview
last sync · just now
HRV · 7-day avg
54 ms
Sleep score
82
DeepCoreREM
08 · Get Soma

Give your agents a nervous system.

Soma for iPhone
$4.99 / month · 30 days free

The always-on health and location pipeline. Unlocks context-aware skills and proactive agent behaviors.

Download on App Store
Requires iOS 17+. Works with or without Apple Watch.
Soma Companion
Free · macOS

Lightweight menubar app. Receives your data and runs the local MCP server your agents connect to.

Mac App Store
Requires macOS 14+. Pairs with Soma for iPhone.

Both apps required for the full pipeline. Start with the 30-day free trial — no commitment.

09 · Common questions

Frequently asked.

Yes. The iPhone app collects and syncs your health and location data. The Mac companion receives it and runs the MCP server. The iPhone app is $4.99/mo (after a 30-day free trial). The Mac companion is completely free.

Soma uses HealthKit's observer queries and native background delivery — both heavily optimized by iOS. Virtually zero impact on daily battery life.

Location data syncs in near-real-time as you move. Health metrics sync periodically in the background as quickly as iOS allows via Background App Refresh (typically every 15–45 minutes depending on device usage).

No. iPhone alone gives location, steps, and basic activity. An Apple Watch adds heart rate, HRV, sleep stages, SpO₂. Soma works great with both, richer with a Watch.

Yes. Soma exposes data via MCP. Natively supported by Claude, Cursor, OpenClaw, Hermes. Works with ChatGPT via local MCP plugins.

The data pipeline stops updating. Skills built on Soma gracefully degrade to their "without Soma" behavior — the agent will simply ask you for the context it needs. No data is deleted from your iCloud.

No. Syncs exclusively through your personal iCloud. We have zero access. The MCP server runs locally on your Mac.

Yes. Skills are standard MCP tools. Full docs, API references, and starter templates in our developer docs.

Yes. Soma works anywhere Apple HealthKit and iCloud are available.

Not yet, but Windows support is in development. The companion will run on Windows and connect to the same MCP server interface.

Your agents are flying blind.
Give them eyes.