Rippd MCP server

Server URL

Remote MCP server over Streamable HTTP. Authentication is OAuth 2.1 with PKCE; assistants that support dynamic client registration configure themselves from the server's OAuth metadata, so no client ID or API key is needed.

Requirements

A Rippd account with Rippd Pro. If the account is not on Pro, the Rippd sign-in step shows a “Pro feature” notice, nothing is shared, and the assistant receives an access-denied response. If Pro ends after you connect, the assistant can still read recent data, but logging is refused with a message that the connection needs an active Pro plan.

How to connect

1. In your assistant, add a custom connector (also called a remote MCP server).
2. Paste the server URL: https://rippd.ai/api/mcp
3. When the assistant opens the Rippd sign-in page, sign in with the account you use in the Rippd app.
4. Review the access requested and choose Allow access.

• Claude

  In Claude’s settings, open Connectors and add a custom connector. Paste the server URL and save.

• ChatGPT

  In ChatGPT’s settings, open the section for apps or connectors and create a custom connector (your plan or workspace may need to allow custom connectors). Paste the server URL and choose OAuth authentication.

• Gemini

  In a Gemini product that supports remote MCP servers, add a new MCP server. Paste the server URL as its HTTP address; the product handles the OAuth sign-in.

Menu names in these apps change over time; look for “connectors”, “apps” or “MCP servers” in settings.

Tools

The assistant decides when to call these, based on what you ask it. Read tools only return data; write tools change your Rippd data.

Read

• get_todayTargets, what has been logged so far, what is remaining, the eating window and planned training for today or a given date.
• get_profileCoaching profile and settings: goals, experience, schedule, body stats, injuries, macro targets per day type, eating window and goal weight.
• get_planThe saved workout plan: each workout with its exercises, sets, reps and target weights.
• get_workoutsRecently logged workout sessions in detail, including the weights actually lifted.
• get_progressRecent weigh-ins and recently logged workouts, for trends.
• get_notesSaved coaching notes, such as preferences, dietary restrictions and injuries.

Write

• log_foodAdds a food with its calories and macros to the food log.
• log_weightRecords a bodyweight in kg for a day; a second entry on the same day replaces the first.
• log_workoutRecords a completed workout session in training history, optionally for an earlier date.
• log_activityLogs movement outside the gym (type, intensity and duration). No calorie estimate is made.
• add_workoutAdds a workout to the Train page, for today only or to the weekly plan.
• update_workoutChanges a saved workout in the plan: its name, exercises or structure.
• remove_workoutDeletes a saved workout from the plan.
• update_targetsChanges daily calorie and macro targets per day type. Values outside plausible ranges are rejected.
• save_noteSaves a short coaching note to remember across conversations.
• delete_noteDeletes a saved coaching note.

Data scope

A connection is tied to the Rippd account that approved it. Every request is checked against that account, and the assistant can only read or change that account's own data — never anyone else's. Access is checked again on every request, so a revoked connection stops working immediately.

Revoking access

• From Rippd: in the Rippd app, open Settings → Connectors and disconnect the assistant. This ends its access on Rippd's side right away.
• From the assistant: remove or disconnect the Rippd connector in the assistant's settings. To be sure access is fully ended, also disconnect it in Rippd as above.

Support and privacy

Questions or problems: support@rippd.ai. How Rippd handles your data is described in the privacy policy.