Setup guide
Give Claude Desktop, Claude Code, Cursor or any MCP app read/write access to your own workouts, nutrition, programs, and fasting data, through a real MCP server, not a demo.
Open the Zealova app → Settings → AI Integrations (under Personalization) → Create Connection. Pick Quick Setup for a safe read-only start, or Custom to also grant write access, logging, program assignment, fasting, coach chat.
The app shows a one-time "Connection Ready" screen with a ready-to-paste JSON block. This is the only time the token is shown in plaintext, copy it now.
{
"mcpServers": {
"zealova": {
"url": "https://mcp.zealova.com/mcp",
"transport": "http",
"headers": {
"Authorization": "Bearer fwz_pat_••••••••••••"
}
}
}
}Edit the config file directly, merge the block above into mcpServers, save.
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Settings → MCP → Add Server → paste the same block.
Skip steps 1–2 and run this instead, then authenticate:
claude mcp add --transport http zealova https://mcp.zealova.com/mcp claude mcp login zealova
The first command only registers the server, it never triggers sign-in itself. login is the separate step that opens your browser to approve the connection. Run claude mcp list afterward to confirm it shows Connected.
Fully quit and reopen Claude Desktop / Cursor, config changes aren't picked up live. Then just ask it something:
> What's my workout today?
Once connected, here's what a real conversation can look like, grouped by what it touches.
get_today_workoutmodify_workoutgenerate_workout_planget_available_programsassign_program_to_schedulelog_meal_from_textsuggest_recipes_from_fridgestart_fastget_readiness_scorechat_with_coachEvery tool, grouped by domain. read:* scopes are safe defaults; write:* scopes change something. A confirm note means Claude has to double-check with you before it runs.
| Tool | Scope | What it does |
|---|---|---|
| Workouts | ||
| get_today_workout | read:workouts | Today's scheduled workout, if any |
| get_workout_history | read:workouts | Past workouts in a date range |
| get_workout_details | read:workouts | Full details of one workout |
| get_exercise_history | read:workouts | Past sets and weights for one exercise |
| log_workout | write:logs | Log a workout you did |
| log_completed_set | write:logs | Log reps/weight/RPE for a set |
| adjust_set_weight | write:logs | Nudge a target weight up or down |
| modify_workout | write:workouts | Add/remove/replace/reschedule an exerciseconfirm on remove |
| generate_workout_plan | write:workouts | Generate a new AI workout, optionally for a chosen target_dateconfirm on replace |
| Programs | ||
| get_available_programs | read:programs | Browse the published program library |
| get_program_details | read:programs | Full days/exercises preview of one program |
| get_program_schedule | read:programs | Multi-week schedule for a program variant |
| get_my_assigned_programs | read:programs | What's currently on your schedule |
| assign_program_to_schedule | write:programs | Start a programconfirm as primary |
| Nutrition | ||
| log_meal_from_text | write:logs | Log a meal from a description |
| update_meal | write:logs | Edit a logged meal |
| delete_meal | write:logs | Remove a logged mealconfirm before delete |
| log_meal_from_image | write:logs | Log a meal from a photo URL |
| get_nutrition_summary | read:nutrition | Daily macro/calorie totals |
| search_food | read:nutrition | Search the food database |
| log_water | write:logs | Log water intake (ml) |
| get_recent_meals | read:nutrition | Most recently logged meals |
| get_favorite_foods | read:nutrition | Saved / favorite foods |
| suggest_recipes_from_fridge | read:nutrition | Recipes from a fridge photo and/or ingredient list |
| Fasting | ||
| start_fast | write:fasting | Start a new fast |
| end_fast | write:fasting | End the active fast, get results + streak |
| get_fasting_status | read:fasting | Active fast (if any) + current streak |
| get_fasting_history | read:fasting | Past fasts |
| Coach & body | ||
| chat_with_coach | chat:coach | Talk to your AI coach agents |
| get_readiness_score | read:scores | Recovery / readiness score |
| get_strength_scores | read:scores | Strength score per muscle group |
| get_streak_and_habits | read:scores | Workout streak + active habits |
| get_progress_photos | read:profile | Recent progress photos |
| get_user_profile | read:profile | Profile, goals, preferences |
| get_body_weight_history | read:profile | Body weight entries over time |
| get_health_metrics | read:scores | Health metrics such as sleep and steps |
| log_body_weight | write:logs | Log a body weight measurement |
| update_user_goal | write:logs | Change your primary goal |
| Exports | ||
| export_user_data | export:data | Export your raw data |
| generate_report | export:data | Generate a formatted report |
Assistants that connect by address (ChatGPT, Claude, Gemini, Mistral Le Chat) use OAuth. You sign in to Zealovaand approve what the assistant can read and log. Lifetime plans are eligible as well as yearly plans. For the short version per assistant, see AI integrations.
token_endpoint_auth_method: none.client_secret_basic. An OAuth client created in the app (Settings, AI integrations, Create Connection, Connect an assistant) gives you a client ID and secret./.well-known/openid-configuration.401 with invalid_token. A compliant client then uses its refresh token to get a new one, with no new sign-in.It's shown once, at creation. Anyone with it can act within the scopes you granted, for as long as the connection exists. Revoke anytime from Settings → AI Integrations.
Cross ~200 tool calls a minute, or 50 meal-logs in 5 minutes, and the whole connection is revoked automatically - you'd need to reconnect from the app.
Fully quit the client (not just close the window) after editing the config, and reopen. Config changes don't hot-reload.
That's intentional for anything with real consequences, replacing your workout plan, ending your active program. Re-send the same request; Claude includes the confirmation token automatically.
The access token expired. A client that follows OAuth refreshes it on its own. If yours does not, disconnect and reconnect the server once.
Settings → AI Integrations → tap the connection → Disconnect. Takes effect immediately.