# Send Apple Health to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "apple-health", "name": "Apple Health", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ivangdavila/apple-health", "canonicalUrl": "https://clawhub.ai/ivangdavila/apple-health", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/apple-health", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-health", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "fallback-cli.md", "mcp-config.md", "memory-template.md", "query-recipes.md", "setup.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/apple-health" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/apple-health", "downloadUrl": "https://openagent3.xyz/downloads/apple-health", "agentUrl": "https://openagent3.xyz/skills/apple-health/agent", "manifestUrl": "https://openagent3.xyz/skills/apple-health/agent.json", "briefUrl": "https://openagent3.xyz/skills/apple-health/agent.md" } } ``` ## Documentation ### Setup On first use, read setup.md for integration guidelines. ### When to Use User wants agents to read Apple Health data for trends, summaries, or SQL analysis. Agent handles export validation, MCP server wiring, and safe query/report flows without exposing private health records. ### Architecture Memory lives in ~/apple-health/. See memory-template.md for setup. ~/apple-health/ |-- memory.md # Status, client integration state, latest export path |-- integrations.md # Connected MCP clients and validation notes |-- query-log.md # Reusable SQL/report prompts and known-good outputs \`-- archive/ # Retired paths and old troubleshooting notes ### Quick Reference Use these files on demand instead of overloading the main instructions. TopicFileSetup processsetup.mdMemory templatememory-template.mdMCP client wiringmcp-config.mdQuery recipesquery-recipes.mdFallback CLI pathsfallback-cli.md ### 1. Confirm Integration Mode Before Doing Anything Start by clarifying one of these modes: csv-export using Apple Health CSV exports and MCP not-now if user is only planning and does not want setup yet Never imply direct HealthKit API access from terminal agents. This skill works from exported data. ### 2. Validate Local Export Before MCP Wiring Require a real export folder before configuration: Must exist locally and be readable Must include files matching HKQuantityTypeIdentifier*.csv, HKCategoryTypeIdentifier*.csv, or HKWorkoutActivityType*.csv Must not be an empty unzip folder If validation fails, stop and fix data path first. ### 3. Run Runtime Preflight Before MCP Configuration Before wiring MCP, verify runtime: node -v should be an LTS line (18, 20, or 22) If npx @neiltron/apple-health-mcp fails with missing duckdb.node, switch to LTS Node and retry Confirm HEALTH_DATA_DIR is available as an absolute path Do not continue while runtime is incompatible. ### 4. Configure MCP With Explicit Path and Command Use the MCP server command from mcp-config.md: Command: npx Args: [@neiltron/apple-health-mcp] Env: HEALTH_DATA_DIR=/absolute/path/to/export Never continue with placeholders or relative paths that are not verified. ### 5. Schema First, Then Queries First run schema discovery (health_schema) and map available tables. Only then run health_query or health_report. If table names differ from expectation, adapt SQL to discovered schema instead of forcing guessed names. ### 6. Use Date-Bounded Queries By Default Every analytical query should include time bounds and clear units. Prefer rolling windows (last 7d, 30d, 90d) and compare at most two windows at once. Avoid unbounded full-history scans unless user explicitly asks. ### 7. Track Data Freshness and Refresh Points Log last export timestamp in memory and warn when data is stale. If user needs current-day insights, request a new iPhone export before claiming "latest" trends. ### Common Traps Assuming live HealthKit access from CLI agents -> setup fails because only exported data is available Using wrong export path in MCP env -> server starts but returns no data Running SQL before schema discovery -> queries fail on wrong table names Unbounded queries on large exports -> slow analysis and noisy output Reporting "today" metrics from stale export -> inaccurate recommendations Running MCP package on non-LTS Node -> DuckDB native module errors can break startup ### External Endpoints EndpointData SentPurposehttps://registry.npmjs.orgPackage install metadata onlyDownload MCP server packagehttps://raw.githubusercontent.comPublic markdown onlyRead validated fallback skill docshttps://apps.apple.comManual app download trafficInstall CSV export app on iPhone No health record rows should be sent externally by default. ### Security & Privacy Data that leaves your machine: Package install requests to npm Optional app download traffic from App Store Data that stays local: Apple Health CSV exports MCP query outputs and summaries Skill memory in ~/apple-health/ This skill does NOT: Access iCloud Health data directly Bypass Apple permission prompts Upload health CSVs unless the user asks for that explicitly ### Trust By using this skill, you rely on third-party tooling (@neiltron/apple-health-mcp and the chosen iPhone export app). Only install and run if you trust those tools. ### Related Skills Install with clawhub install if user confirms: health - General health guidance boundaries and framing ios - iOS-specific setup and platform troubleshooting sleep - Sleep trend interpretation workflows api - Reliable API and integration debugging habits swift - HealthKit-side implementation context when app code is involved ### Feedback If useful: clawhub star apple-health Stay updated: clawhub sync ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ivangdavila - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/apple-health) - [Send to Agent page](https://openagent3.xyz/skills/apple-health/agent) - [JSON manifest](https://openagent3.xyz/skills/apple-health/agent.json) - [Markdown brief](https://openagent3.xyz/skills/apple-health/agent.md) - [Download page](https://openagent3.xyz/downloads/apple-health)