# HealthKit MCP\n\nTimothy's Apple HealthKit workout integration for Simtheory.ai.\n\n## Overview\n\nThis service receives workout data from iOS Shortcuts and serves it via MCP protocol.\nCaptures: **Functional Training, Golf, Yoga, Running, Rowing, Walking**, and other workout types.\n\n## Architecture\n\n```\niOS Shortcuts (HealthKit) --> POST /ingest/workouts --> HealthKit MCP --> Simtheory.ai\n```\n\n1. **iOS Shortcut** reads HealthKit workouts on your iPhone\n2. **Shortcut Automation** runs daily (or on-demand)\n3. **POSTs data** to this service on Railway\n4. **MCP endpoints** serve workout data to Simtheory.ai\n\n## Endpoints\n\n### Ingest (from iOS Shortcut)\n- `POST /ingest/workouts` - Receive workouts from iOS Shortcut\n- `POST /ingest/workouts/batch` - Alternative batch format\n\n### Data (query workouts)\n- `GET /data/workouts?days=7` - Get recent workouts\n- `GET /data/workouts/today` - Get today's workouts\n- `GET /data/workouts/date/{date}` - Get workouts for specific date\n- `GET /data/workouts/type/{type}` - Get workouts by type\n- `GET /data/workouts/summary?days=7` - Get workout summary\n\n### MCP Protocol (for Simtheory.ai)\n- `GET /mcp` - Service discovery\n- `GET /mcp/tools/get_workouts` - Get workouts tool\n- `GET /mcp/tools/get_todays_workouts` - Get today's workouts tool\n- `GET /mcp/tools/get_workout_summary` - Get summary tool\n\n## Deployment\n\n### Railway\n\n1. Connect this repo to Railway\n2. Set environment variables:\n - `HEALTHKIT_API_KEY` - Optional API key for security\n - `WORKOUT_STORAGE_PATH` - Optional, defaults to `/tmp/workouts.json`\n3. Deploy!\n\n## iOS Shortcut Setup\n\nSee `docs/ios_shortcut.md` for instructions on creating the iOS Shortcut.\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PORT` | Server port | 8000 |\n| `HEALTHKIT_API_KEY` | Optional API key | (none) |\n| `WORKOUT_STORAGE_PATH` | File storage path | `/tmp/workouts.json` |\n\n## Supported Workout Types\n\n- Functional Training\n- Golf\n- Yoga\n- Running\n- Rowing\n- Walking\n- Cycling\n- Swimming\n- HIIT\n- Strength Training\n- (any other HealthKit workout type)\n