Usage guide
Nexus
Connect the remote MCP server at https://mcp.nexus.kushalsm.com/mcp,
sign in through the Nexus OAuth flow, and use Nexus from ChatGPT,
Claude, Codex, or another MCP-aware client.
Tools
Tool names vary by host and catalog version. Read the illustrated guides for meals, completed workouts, and workout sessions. Public product and image catalog.
nexus_log_entries: add workouts, meals, or body-weight entries.nexus_show_interface: show the interactive Nexus interface, currently focused on a requested log date.nexus_get_history: read your entries, date ranges, exercise keys, and shared friend history.nexus_update_entry: replace an existing entry by ID.nexus_manage_friends: list, add, accept, reject, or remove friend connections.nexus_set_goal: change daily calorie and macro targets.- Workout sessions: create or update a plan, open its session link, mark completed sets, then Finish to save the workout. Discover the available planning tool in your connected host.
- Workout sessions: create or update a plan, open its session link, mark completed sets, then Finish to save the workout. Discover the available planning tool in your connected host.
Example prompts
- "I just did bench press, 3 sets: 60kg for 8, 60kg for 7, and 55kg for 6."
- "I had lunch: 2 chapatis, egg bhurji, and a small salad. Estimate macros and log it."
- (photo of your plate) "Log this. I ate about half the rice."
- (photo of a nutrition label) "Log one serving of this."
- (photo of a restaurant bill) "Log my lunch from this."
- (dictated, or said in a ChatGPT voice conversation) "Two boiled eggs and black coffee for breakfast."
- "What did I eat and train today?"
- "Actually that first bench set was 9 reps, not 8."
- "What's my Nexus friend code?"
CLI
For terminal use:
pip install nexus-fitness
nexus auth login
nexus history
Good to know
- Text, photos (plates, nutrition labels, restaurant bills), dictation and ChatGPT voice all work. ChatGPT or Claude reads them and estimates the nutrition; Nexus saves it.
- Any entry can be corrected on the card or by saying so; totals update.
- Try the tools and card without an account in the sandbox.
- Nexus is a log, not medical advice, diagnosis or treatment guidance.