{
  "markdown": "<p align=\"center\">\n  <img src=\"https://wellnessproject.ai/images/brand/mcp-icon-512.png\" alt=\"Wellness Project\" width=\"220\">\n</p>\n\n# Wellness Project MCP\n\n[![MCP Marketplace](https://img.shields.io/badge/MCP%20Marketplace-Indexed-blueviolet)](https://getlulu.dev/mcps)\n[![MCPVault: claimed](https://mcpvault.io/badge/wellness-project-mcp.svg)](https://mcpvault.io/servers/wellness-project-mcp/health?utm_source=external_badge&utm_medium=referral&utm_campaign=mcp_health_report)\n[![MCP status](https://mcpi.app/servers/wellness-project/badge.svg)](https://mcpi.app/servers/wellness-project)\n[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/wellnessproject-ai)\n[![Wellness Project MCP server — quality and maintenance score on Glama](https://glama.ai/mcp/servers/turnnoblindeye/wellness-project-mcp/badges/score.svg)](https://glama.ai/mcp/servers/turnnoblindeye/wellness-project-mcp)\n\n**Bring connected health and fitness data into Claude, ChatGPT, Gemini Spark, Grok, Mistral, and other MCP clients.** Wellness Project is a hosted Model Context Protocol server. Your devices and logs sync into one account, and supported assistants can read or update workouts, nutrition, sleep, recovery, body metrics, goals, labs, wellbeing, and more in plain English.\n\nThis repository is the public documentation and catalog for the hosted server. It is not a self-hosted backend and contains no private server implementation.\n\n- App: https://wellnessproject.ai\n- MCP endpoint: `https://wellnessproject.ai/api/mcp`\n- **73 advertised public tools** generated from the production tool registry\n- **15 active interactive widgets** for compatible MCP Apps UI clients\n- OAuth 2.1 authentication with Dynamic Client Registration\n\n---\n\n## What you can ask\n\nOnce connected, ask naturally and the assistant can call the matching Wellness Project tool:\n\n- \"How did my training look this week?\"\n- \"Show my sleep for the last month.\"\n- \"How is my bench progressing?\"\n- \"Log today's lunch: chicken burrito bowl, about 700 calories.\"\n- \"What was my resting heart rate trend vs my HRV this quarter?\"\n- \"How am I doing against my goals?\"\n- \"Log 16 ounces of water.\"\n\nRead tools return your logged and synced health data. Write tools add, update, or delete entries when you ask. Widget tools can render structured interactive views instead of a wall of numbers.\n\n## Connect Wellness Project to an MCP client\n\nFirst create an account at https://wellnessproject.ai and connect the health sources you want under **Settings → Devices**. Every client below uses the same hosted endpoint:\n\n`https://wellnessproject.ai/api/mcp`\n\nAuthentication is handled by OAuth. Personal API keys are not part of the current public connection flow.\n\n### Claude\n\n1. Open Claude on the web.\n2. Go to **Customize → Connectors → Add custom connector**.\n3. Paste `https://wellnessproject.ai/api/mcp`.\n4. Leave Client ID and Client Secret blank if Claude shows those fields. Claude can register itself dynamically.\n5. Sign in to Wellness Project and authorize the connection.\n\n### Claude Code\n\nClaude Code installs Wellness Project as a plugin. The plugin carries nothing but\nthis server's configuration and a setup skill.\n\n```\n/plugin marketplace add turnnoblindeye/wellness-project-mcp\n/plugin install wellness-project\n```\n\nRestart Claude Code, then run `/mcp`, select **wellness-project**, and authorize.\nThere is no client ID, client secret, or API key to enter. Run\n`/wellness-project:setup` if you would rather be walked through it.\n\n### Cline\n\nCline connects to Wellness Project as a remote MCP server. Nothing is cloned,\ninstalled, or run locally.\n\n1. Open the **MCP Servers** icon in the Cline sidebar and choose **Remote Servers**.\n2. Enter a server name, for example `wellness-project`.\n3. Paste `https://wellnessproject.ai/api/mcp` as the server URL and add it.\n4. Complete the Wellness Project OAuth flow when Cline opens it in your browser.\n\nTo edit `cline_mcp_settings.json` directly instead:\n\n```json\n{\n  \"mcpServers\": {\n    \"wellness-project\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"https://wellnessproject.ai/api/mcp\",\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\nSet `\"type\": \"streamableHttp\"` explicitly. Cline falls back to the legacy SSE\ntransport when the type is omitted. There is no client ID, client secret, or API\nkey to enter. [llms-install.md](./llms-install.md) has the same steps written for\nan agent doing the setup.\n\n### ChatGPT\n\nChatGPT custom MCP apps use developer mode. Current OpenAI availability is plan-dependent: full MCP support including write/modify actions is available in beta for Business, Enterprise, and Edu, while Pro can connect MCPs with read/fetch permissions in developer mode.\n\n1. Enable developer mode for your account or workspace as permitted by your ChatGPT plan.\n2. Create a custom MCP app from ChatGPT's Apps settings.\n3. Use `https://wellnessproject.ai/api/mcp` as the remote MCP server.\n4. Complete the Wellness Project OAuth flow.\n\nOpenAI's current setup and plan details: https://help.openai.com/en/articles/12584461\n\n### Gemini Spark\n\nCustom MCP apps require Gemini Spark access and are added from the Gemini web app.\n\n1. Go to https://gemini.google.com.\n2. Open **Settings & help → Connected Apps**. If needed, open **Personal Intelligence → Connected Apps** first.\n3. Under **Custom apps for Spark**, choose **Add a custom app**.\n4. Enter `https://wellnessproject.ai/api/mcp` and click **Next**.\n5. Complete the Wellness Project OAuth flow.\n\nGoogle's current eligibility and availability rules: https://support.google.com/gemini/answer/17209137\n\n### Grok\n\n1. Go to https://grok.com/connectors and choose **New Connector → Custom**.\n2. Paste `https://wellnessproject.ai/api/mcp`.\n3. Leave Client ID and Client Secret blank if those fields appear.\n4. Complete the Wellness Project OAuth flow.\n\nGrok connector availability may depend on your Grok plan.\n\n### Mistral Le Chat\n\n1. In Le Chat, open **Intelligence → Connectors → Add Connector → Custom MCP Connector**.\n2. Paste `https://wellnessproject.ai/api/mcp`.\n3. Leave Client ID and Client Secret blank if those fields appear.\n4. Complete the Wellness Project OAuth flow.\n\nWorkspace permissions may require an owner or admin to add a connector.\n\n## Demo\n\nA short screen recording of the Wellness Project connector running inside ChatGPT:\n\n<video src=\"https://github.com/turnnoblindeye/wellness-project-mcp/raw/main/media/chatgpt-connector-demo.mp4\" controls muted></video>\n\n**[Download / watch the demo](./media/chatgpt-connector-demo.mp4)**\n\n## Interactive widgets\n\nFifteen active tools render interactive views through the MCP Apps UI extension in compatible clients:\n\n| Ask | Widget tool |\n|---|---|\n| \"Give me a health overview\" | `show_health_overview` |\n| \"How did my Fit Score look?\" | `show_week_fit_score` |\n| \"Show my workouts\" | `show_week_workouts` |\n| \"Show that workout\" | `show_workout` |\n| \"Show my macros\" | `show_week_macros` |\n| \"Show my meal diary\" | `show_meal_diary` |\n| \"How's my sleep trending?\" | `show_week_sleep` |\n| \"Show last night's sleep\" | `show_sleep_detail` |\n| \"Steps this week?\" | `show_week_steps` |\n| \"My weight trend\" | `show_body_weight` |\n| \"Show my body composition\" | `show_body_composition` |\n| \"Recovery trend\" | `show_recovery` |\n| \"How's my running?\" | `show_runs` |\n| \"How's my bench progressing?\" | `show_exercise_progression` |\n| \"Show my wellbeing\" | `show_wellbeing` |\n\nMany trend widgets support multiple time ranges; detail widgets use the date or record relevant to the request.\n\n## Tool catalog\n\nThe complete production-generated list of **73 advertised public tools**, grouped by domain, is in **[TOOLS.md](./TOOLS.md)**. The machine-readable descriptions, annotations, and JSON Schemas are in **[catalog/tools.json](./catalog/tools.json)**.\n\nBoth files are generated from the same production tool registry used by `tools/list`. Admin-only tools and retired tools that remain callable only for older cached clients are not advertised in this catalog.\n\nDo not edit the generated catalog by hand.\n\n## Data sources and integrations\n\nWellness Project combines native mobile health stores, direct integrations, relay sources, and manual/chat logging.\n\n| Source | Current support |\n|---|---|\n| Apple Health | Native iOS health and fitness sync |\n| Google Health Connect | Native Android health and fitness sync |\n| Fitbit / Google Health | Activity, sleep, heart, workout, body, and nutrition data when available |\n| Oura | Sleep, readiness/recovery, heart, and activity data |\n| Withings | Body, sleep, activity, heart, blood pressure, and other supported health data |\n| Wyze | Supported Wyze health data |\n| Hevy | Strength workout history via direct integration |\n| Ultrahuman | Ring data and supported metabolic/CGM data |\n| Liftosaur | Strength workout history via direct integration |\n| Polar | Activity, sleep, recovery, heart, and training data |\n| WHOOP | Direct integration is rolling out behind availability gating |\n| Manual / chat | Workouts, meals, hydration, body metrics, labs, injuries, supplements, goals, wellbeing, and more |\n\nGarmin, Samsung Health, Amazfit/Zepp, Coros, Wahoo, Strava, Peloton, smart scales, and other compatible sources can also reach Wellness Project through Apple Health or Health Connect when those services write the relevant data there.\n\n## Pricing and status\n\nPricing below reflects the current production configuration as of September 7, 2026. Local app-store pricing may vary.\n\n| Plan | Price | Status |\n|---|---:|---|\n| Free Basic | $0 | Logging and editing remain free; starting October 15, 2026, Free includes 3 analysis questions per day |\n| Founder Pro monthly | $4.99/month | Founder pricing through October 15, 2026 |\n| Founder Pro annual | $39.99/year | Founder pricing through October 15, 2026 |\n| Founder Lifetime | $199 one-time | Limited founder option, sunsetting |\n| Pro monthly | $9.99/month | Standard pricing |\n| Pro annual | $99.99/year | Standard pricing |\n\n## Privacy and auth\n\n- The public MCP endpoint uses OAuth 2.1; supported clients can register dynamically.\n- Every MCP request is scoped to the authenticated Wellness Project account.\n- Row-level security protects user-owned records in the data layer.\n- Connector access can be revoked without self-hosting or rotating a long-lived personal API key.\n\nWellness Project is informational software, not a medical product.\n\n## FAQ\n\n### Do I have to self-host anything?\n\nNo. `https://wellnessproject.ai/api/mcp` is the hosted production server. This GitHub repository publishes documentation and schemas only.\n\n### Does the same endpoint work across AI assistants?\n\nYes. Claude, eligible ChatGPT accounts/workspaces, Gemini Spark, Grok, Mistral, and other compatible remote MCP clients can use the same endpoint. Client-side MCP availability and permissions vary by product and plan.\n\n### Is Wellness Project free?\n\nFree Basic is available. Paid Founder Pro and standard Pro plans add analysis capacity and other paid capabilities; current pricing is listed above.\n\n### Is my health data private?\n\nMCP access requires an authenticated OAuth grant and each tool operates on the signed-in user's account. You can revoke connector access when you no longer want a client connected.\n\n## Related\n\n- Works with Wellness Project: https://wellnessproject.ai/works-with\n- Connect Apple Health to Claude: https://wellnessproject.ai/integrations/apple-health-to-claude\n- Fitbit MCP: https://wellnessproject.ai/integrations/fitbit-mcp\n- Claude integration: https://wellnessproject.ai/integrations/claude\n- ChatGPT integration: https://wellnessproject.ai/integrations/chatgpt\n\n## License\n\nThe tool catalog and schemas in this repository are published under the [MIT License](./LICENSE) so MCP clients and directories can reference them freely. \"Wellness Project\" and the app itself remain the property of Wellness Project LLC. See [NOTICE](./NOTICE) for the scope of the grant.\n",
  "bytes": 11969,
  "sha": "c41752d89a09970a4db222f942e93f5542cc0240adedf9bba77541e7d5d22fed",
  "repo_slug": "turnnoblindeye/wellness-project-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_wellnessproject_wellness_project_812ee8c7/readme"
}