MCP server exposing Soma's local SQLite sensor replica to AI agents
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"soma-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# soma-mcp MCP server that exposes Soma's local Mac SQLite sensor replica to AI agents. Reads from a local SQLite replica maintained by the [Soma Mac app](https://github.com/dylan-buck/Soma). Designed for use with any MCP-compatible agent (Claude, ChatGPT, Cursor, etc.). In the App Store-safe build, HealthKit-derived rows are not synced through CloudKit, so health tools may return empty or stale data unless the local replica was populated by a future compliant transport. Location and activity tools continue to read replicated Mac data. If Soma Mac has **Agent Access** turned off, every MCP tool returns a permission error with instructions to re-enable access in the Mac app. The local SQLite replica may still exist and continue syncing; the toggle only controls whether `soma-mcp` is allowed to serve it. ## Consumer Setup For end users, the Soma Mac app generates the correct MCP configuration automatically from the menu bar. Until `soma-mcp` 0.2.1 is published on PyPI, use a local checkout with `uvx --from <path-to-soma-mcp> soma-mcp`. Do not use unpinned `uvx soma-mcp`; PyPI may resolve an older package. ## Development Quick Start ```bash cd soma-mcp uv run soma-mcp --db ~/.soma/sensors.db ``` ## Agent Configuration The Soma Mac app generates the correct config for your machine — open the menu bar and click **Copy Agent Config**. Manual setup is below. ### Claude Desktop Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows): ```json { "mcpServers": { "soma": { "type": "stdio", "command": "uvx", "args": ["--from", "/path/to/Soma/soma-mcp", "soma-mcp", "--db", "~/.soma/sensors.db"] } } } ``` ### Claude Code Use the CLI (recommended): ```bash claude mcp add --transport stdio --scope user soma -- uvx --from /path/to/Soma/soma-mcp soma-mcp --db ~/.soma/sensors.db ``` Or edit `~/.claude.json` (user scope) / `.mcp.json` (project scope) with …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.