Setup guide

Connect Zealova to Claude

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.

Requires
Yearly or lifetime plan
Client
ChatGPT, Claude, Gemini, Cursor or any MCP app
Time
~2 minutes

Connect

  1. 1

    Create a connection in the app

    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.

  2. 2

    Copy the generated config

    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_••••••••••••"
          }
        }
      }
    }
  3. 3

    Paste it into your client

    Claude Desktop

    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

    Cursor

    Settings → MCP → Add Server → paste the same block.

    Claude Code CLI, the fast path

    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.

  4. 4

    Restart and verify

    Fully quit and reopen Claude Desktop / Cursor, config changes aren't picked up live. Then just ask it something:

    > What's my workout today?

Try it

Once connected, here's what a real conversation can look like, grouped by what it touches.

Workouts
"What's my workout today, and swap the barbell row for something with dumbbells."
callsget_today_workoutmodify_workout
"Generate me a new 4-day upper/lower split."
callsgenerate_workout_plan
Programs
"Show me beginner strength programs, 3 days a week."
callsget_available_programs
"Start the HYROX prep program as my primary."
callsassign_program_to_schedule
Nutrition
"I had 2 eggs and toast for breakfast, log it."
callslog_meal_from_text
"Here's a photo of my fridge, what can I cook that's high protein?"
callssuggest_recipes_from_fridge
Fasting & coach
"Start a 16:8 fast for me."
callsstart_fast
"How's my recovery, should I train legs today?"
callsget_readiness_scorechat_with_coach

Full tool reference

Every 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.

ToolScopeWhat it does
Workouts
get_today_workoutread:workoutsToday's scheduled workout, if any
get_workout_historyread:workoutsPast workouts in a date range
get_workout_detailsread:workoutsFull details of one workout
get_exercise_historyread:workoutsPast sets and weights for one exercise
log_workoutwrite:logsLog a workout you did
log_completed_setwrite:logsLog reps/weight/RPE for a set
adjust_set_weightwrite:logsNudge a target weight up or down
modify_workoutwrite:workoutsAdd/remove/replace/reschedule an exerciseconfirm on remove
generate_workout_planwrite:workoutsGenerate a new AI workout, optionally for a chosen target_dateconfirm on replace
Programs
get_available_programsread:programsBrowse the published program library
get_program_detailsread:programsFull days/exercises preview of one program
get_program_scheduleread:programsMulti-week schedule for a program variant
get_my_assigned_programsread:programsWhat's currently on your schedule
assign_program_to_schedulewrite:programsStart a programconfirm as primary
Nutrition
log_meal_from_textwrite:logsLog a meal from a description
update_mealwrite:logsEdit a logged meal
delete_mealwrite:logsRemove a logged mealconfirm before delete
log_meal_from_imagewrite:logsLog a meal from a photo URL
get_nutrition_summaryread:nutritionDaily macro/calorie totals
search_foodread:nutritionSearch the food database
log_waterwrite:logsLog water intake (ml)
get_recent_mealsread:nutritionMost recently logged meals
get_favorite_foodsread:nutritionSaved / favorite foods
suggest_recipes_from_fridgeread:nutritionRecipes from a fridge photo and/or ingredient list
Fasting
start_fastwrite:fastingStart a new fast
end_fastwrite:fastingEnd the active fast, get results + streak
get_fasting_statusread:fastingActive fast (if any) + current streak
get_fasting_historyread:fastingPast fasts
Coach & body
chat_with_coachchat:coachTalk to your AI coach agents
get_readiness_scoreread:scoresRecovery / readiness score
get_strength_scoresread:scoresStrength score per muscle group
get_streak_and_habitsread:scoresWorkout streak + active habits
get_progress_photosread:profileRecent progress photos
get_user_profileread:profileProfile, goals, preferences
get_body_weight_historyread:profileBody weight entries over time
get_health_metricsread:scoresHealth metrics such as sleep and steps
log_body_weightwrite:logsLog a body weight measurement
update_user_goalwrite:logsChange your primary goal
Exports
export_user_dataexport:dataExport your raw data
generate_reportexport:dataGenerate a formatted report

Sign in with OAuth

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.

  • Public clients are supported with PKCE: register with token_endpoint_auth_method: none.
  • Confidential clients can authenticate with 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.
  • Discovery is at /.well-known/openid-configuration.
  • When an access token expires the server answers 401 with invalid_token. A compliant client then uses its refresh token to get a new one, with no new sign-in.

Security & limits

30
calls / minute
500
calls / hour
25
writes / hour
10
coach chats / hour
Treat the token like a password

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.

Auto-revoke on abuse

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.

If something doesn't work

Claude says it can't find any Zealova tools

Fully quit the client (not just close the window) after editing the config, and reopen. Config changes don't hot-reload.

A write call keeps asking me to confirm

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.

A tool call returns 401 invalid_token

The access token expired. A client that follows OAuth refreshes it on its own. If yours does not, disconnect and reconnect the server once.

I want to revoke access

Settings → AI Integrations → tap the connection → Disconnect. Takes effect immediately.