Do I need to write any code to connect kontest to Claude, ChatGPT, or Gemini?

No. In all three you paste the server URL into a settings screen: Connectors in Claude, Connectors in ChatGPT, and Connected apps in Gemini. There is nothing to install and no code to write.

Which apps can I use the kontest MCP server with?

Claude, ChatGPT, and Gemini all support remote MCP servers, and so does any other client that speaks MCP over HTTP. The setup is the same everywhere: one URL and a kontest sign-in.

Does the kontest MCP server cost anything?

No. It is included with your free kontest account. Custom connectors are usually a paid-plan feature in Claude, ChatGPT, and Gemini, so check your plan there if you do not see the option.

Can Claude change my kontest data?

Yes, that is the point of the write tools: logging a workout, logging a meal, joining a kontest. Your client asks for permission before it runs a tool, and you can decline or remove the connector at any time.

How do I disconnect the kontest MCP server?

Remove the connector in your client's settings. The access token stops working immediately and nothing further can read or write your kontest data.

kontest MCP

Your training log, inside the AI you already use.

Q: What is MCP?

Model Context Protocol is an open standard that lets an AI assistant talk to an outside service. The kontest MCP server is the endpoint your assistant connects to. You paste one URL, sign in, and it learns which kontest actions it is allowed to take.

The kontest MCP server gives your assistant a live, permissioned connection to your workouts, nutrition, kontests, and personal records. Paste one URL, sign in once, then ask for what you want in plain language.

Watch the setup

Free with your kontest account · Works with Claude, ChatGPT & Gemini

Remote MCP server

https://mcp.thekontest.com/mcp

Transport: streamable HTTP. You sign in the same way you sign in to the kontest app, with your email and password or with Apple. No API keys to generate, store, or rotate.

27 tools Read & write Live

Once it is connected

“Log today's workout: bench three sets of eight at 185, then tell me where my streak stands.”

Logged, and the volume is on your board. Your weekly streak is safe, and the session is already counting toward every kontest you are in.

Setup in Claude

One URL. Four steps. About a minute.

Here is the whole thing, start to finish, in Claude. The same four steps apply on desktop and on the web. ChatGPT and Gemini are just below.

Connecting kontest to Claude 30 seconds, no sound Interface shown for illustration

Open Connectors in Claude settings

In Claude, go to Settings and open the Connectors section. This is where Claude keeps every outside service it can reach.

Add a custom connector

Choose Add custom connector. Name it kontest, paste https://mcp.thekontest.com/mcp as the remote MCP server URL, and press Add. Leave the advanced OAuth fields empty. kontest does not need them.

Sign in with your kontest account

Press Connect and a browser window opens on kontest. Sign in exactly the way you sign in to the app, with your email and password or with Apple, then approve the access kontest lists. The window closes itself and Claude shows the connector as connected.

Ask for what you want

Start a chat and talk normally. Ask Claude to log the session you just finished, pull your bench numbers for the year, or set up a three-week kontest with your friends.

Other assistants

The same URL in ChatGPT and Gemini.

Both take remote MCP servers too. Only the settings screen changes, and the sign-in still happens in your browser on kontest.

ChatGPT

Web and desktop · about a minute

Open Settings, then Connectors. Click your name in the bottom corner, choose Settings, and open the Connectors section.
Turn on developer mode. Scroll to Advanced inside Connectors and switch on developer mode. This is what lets ChatGPT take a custom MCP server.
Choose Create. Go back to Connectors. There is now a Create button for adding your own.
Fill in the two fields. Name it kontest and paste https://mcp.thekontest.com/mcp as the MCP server URL. Leave authentication set to OAuth.
Confirm and create. Tick the box saying you trust the provider, press Create, and sign in to kontest in the browser window that opens.
Switch it on in a chat. Open the developer mode menu in the composer and enable kontest for that conversation, then ask away.

Custom connectors are a paid ChatGPT plan feature. If you do not see Advanced under Connectors, check your plan.

Gemini

gemini.google.com · about a minute

Open Settings and help. Go to gemini.google.com and open Settings and help from the menu.
Go to Connected apps. Choose Connected apps. If you do not see it straight away, open Personal intelligence first and it is in there.
Add a custom app. Find the custom apps section and choose Add a custom app.
Paste the URL. Enter https://mcp.thekontest.com/mcp as the MCP server URL and press Next. Leave the advanced credential fields alone.
Sign in to kontest. A browser window opens on kontest. Sign in the way you always do and approve the access it lists.
Just ask. Start a chat and ask about your training. Gemini picks the right kontest tools on its own.

Custom apps are rolling out gradually on personal Google accounts, and availability varies by region and language.

Using something else? Any client that speaks MCP over HTTP works with the same URL, including Claude Code, Cursor, and the Gemini CLI. Point it at https://mcp.thekontest.com/mcp and sign in when the browser window opens.

Tool catalog

All 27 tools, and what each one does.

Your client reads this list the moment you connect. You never have to name a tool yourself: ask in plain language and the right ones get used.

Training log

8 tools

log_workoutLog a full session: date, duration, intensity, notes, and every exercise with its sets, reps, and weight.

log_quick_workoutOne-shot log for a session where the detail does not matter. Type, duration, done.

get_workout_historyPull logged sessions by day range or exercise name, up to 90 days back.

get_workout_detailEverything from one session: sets, reps, weight, partners, and notes.

get_personal_recordsPersonal records across a date range, or filtered to a single lift.

get_muscle_focus_breakdownPrimary and secondary muscle volume over a 7, 30, or 90 day window.

get_exercise_librarySearch the exercise library by name or muscle group.

create_custom_exerciseAdd a movement that is not in the library yet, with its target muscles.

Nutrition and recovery

7 tools

log_mealDescribe a meal in plain words. Leo estimates the calories and macros, the same way the app does.

get_meal_historyEvery meal you have logged, optionally for one month.

get_nutrition_summaryToday's calories and macros against your targets, plus your logging streak.

get_nutrition_targetsYour current calorie and macro goals, dietary preferences, and allergens.

update_nutrition_targetsSet daily calorie and macro targets by hand, with an optional goal.

suggest_mealAsk Leo for a meal that fits the macros you have left today. Suggests only, logs nothing.

log_sleep_qualityLog sleep quality from 1 to 5 for a date, with hours slept if you know them.

Competition and friends

8 tools

list_kontestsYour kontests, filtered to ongoing, upcoming, or completed.

get_kontest_detailRules, duration, participants, and the live leaderboard for one kontest.

create_kontestStart a challenge: title, accepted types, workouts per week, dates, and who is invited.

join_kontestJoin a kontest you have been invited to or a public one.

leave_kontestStep out of a kontest you have joined.

list_friendsYour friends list, with levels and points.

send_friend_requestSend a friend request by user id.

respond_to_friend_requestAccept or decline a request that is waiting on you.

Profile and settings

4 tools

get_my_statsWorkout counts and volume over the period you are tracking.

get_profileLevel, points, badges, and lifetime totals.

update_notification_preferencesTurn notification categories on or off: reminders, invites, nutrition, updates.

update_privacy_settingsControl activity sharing, whether partners show, and achievement visibility.

What to ask

Talk to it like a training partner who keeps the records.

Real requests, and the tools that answer them behind the scenes.

“Log yesterday's session: squat five sets of five at 275, then show me how much leg volume I have done this month.”

log_workout · get_muscle_focus_breakdown

“What is my bench press record this year, and how far off it am I right now?”

get_personal_records · get_workout_history

“Set up a three-week kontest with my friends, five workouts a week, and invite everyone on my list.”

list_friends · create_kontest

“I had two eggs, oatmeal, and a protein shake. Where does that leave me for the day?”

log_meal · get_nutrition_summary

“Slept five hours and feel wrecked. Log it, then give me something lighter than what I had planned.”

log_sleep_quality · get_workout_history

“Which muscle groups have I been neglecting for the last 30 days?”

get_muscle_focus_breakdown · get_my_stats

Access and control

Your data, on your terms.

The connection is scoped to one account, yours, and you can cut it at any time. There is no key to leak and nothing to configure beyond signing in.

You sign in, not a key

You authorize the connection from your kontest account, signed in the same way you sign in to the app: email and password, or Apple. There is no API key to paste into a config file or leave sitting in a repo.

Scoped to your account

Every tool reads and writes as you. Other athletes' logs stay theirs, and your existing privacy settings still apply.

Approve before it acts

Your client asks before it runs a tool that changes something. Logging a workout or joining a kontest happens because you said yes.

Revoke in one move

Remove the connector in your client, or turn it off for a single chat. Access ends immediately either way.

Before you connect

Questions worth answering first.

01What is MCP, in plain terms?

Model Context Protocol is an open standard for letting an AI assistant talk to an outside service. The kontest MCP server is the endpoint your assistant connects to. You paste one URL, sign in, and it learns which kontest actions it is allowed to take. Nothing else to install.

02Do I need to write code?

No, not in any of the three. You paste the server URL into a settings screen and that is the whole setup: Connectors in Claude, Connectors in ChatGPT, Connected apps in Gemini. Nothing to install, nothing to configure.

03Which apps can I use it with?

Claude, ChatGPT, and Gemini, plus any other client that speaks MCP over HTTP. The server does not care which one you use, and more apps keep adding support.

04Does it cost anything?

The kontest MCP server is included with your account at no charge, the same as logging and competing. Custom connectors tend to be a paid-plan feature in Claude, ChatGPT, and Gemini, so if you do not see the option, check which plan you are on there.

05Can it change my data, or only read it?

Both, and that is the useful part. It can log workouts, log meals, set your macro targets, and create or join kontests. Your assistant asks for permission before it runs one of those tools, and repeated identical logs are deduplicated so a retry will not double-count your session.

06How do I disconnect it?

Remove the connector in that app's settings and the access token stops working right away. You can also leave it connected and switch it off for a single conversation when you would rather keep that chat to yourself.

Building something on top of the kontest MCP server, or want a tool that is not in the list yet? Tell me what you are trying to do and I will look at adding it. I read every message myself.

Matt, founder of kontest