YYUHA
Training PlansRacesRun Clubs
Sign inSign up

Connect YUHA Coach to your assistant

Last updated: 18 November 2026

On this page

Claude
  • Web and desktop app
  • Claude Code
  • Claude Code plugin
ChatGPT
  • Turn on developer mode
  • Create the connector
  • Sign in and allow
  • Switch it on in a chat
  • Check and disconnect
Codex
  • Add the server
  • Sign in and allow
  • Check and disconnect
Gemini
  • Ask YUHA for a client
  • Sign in and allow
  • Check and disconnect
Other assistants
  • Add the address
  • Sign in and allow
  • Check and disconnect
About the connector
  • Where it works
  • What it can read
  • Permissions
  • If it does not work
  • Disconnect

YUHA Coach MCP is YUHA's connector for assistants. MCP is the open standard assistants use to call another service's tools. It reads only your own data, never anyone else's.

YUHA Coach for assistants is rolling out in a private beta. Until it reaches your account, your assistant's first step is refused, and nothing else in YUHA changes.

Once connected, your assistant answers with your own YUHA data. It quotes YUHA's decision for your day and changes nothing in YUHA. Every platform uses the same address: https://yuha.app/mcp. The first time you sign in, YUHA shows its own permission page, with five groups to tick.

Claude

Claude on the web and the desktop app

You need a Pro or Max plan. Connectors are set up through your Claude account, so the connection is made from Anthropic's servers, not from your computer.

Add the connector

  1. Open Claude, then Customize, then Connectors.
  2. Click + Add, then Add custom connector.
  3. Name it YUHA Coach.
  4. Paste https://yuha.app/mcp as the server URL and click Continue.
  5. Keep the authentication Claude detected and click Continue.
  6. Under Authentication, choose Sign in now.
  7. Under OAuth client, choose Register automatically. Claude's recommended option, its published identity, is being switched on during the beta, and this page will say so when it is.
  8. Leave Request headers empty and click Add.

Sign in and allow

  1. Claude opens YUHA's sign-in. Sign in, tick the groups you want it to read, and approve.

Switch it on in a chat

  1. In a chat, click + at the lower left, then Connectors, and switch YUHA Coach on for that conversation.

Team and Enterprise plans

On a Team or Enterprise plan, an Owner adds it first. They open Organization settings, then Connectors, then Add, then Custom, then Web, with the same name, URL and OAuth client choice. Members then open Customize, then Connectors, find YUHA Coach and click Connect.

Check and disconnect

Check it worked: ask "What should I do today and why?" The answer names YUHA Coach as its source.

To disconnect: open Customize, then Connectors, click the three dots next to YUHA Coach and choose Remove. Or in YUHA, open Account, then Connected apps, and click Disconnect.

Claude's guide: Getting started with custom connectors.

Claude Code

Claude Code runs in your terminal, so the connection is made from your own computer.

Add it and sign in

  1. In a terminal, run:
    claude mcp add --transport http yuha https://yuha.app/mcp
  2. Start Claude Code and type /mcp. Select yuha and follow the sign-in in your browser: sign in to YUHA, tick the groups and approve. If the browser does not open, copy the URL Claude Code prints. If the redirect fails after you approve, paste the full callback URL from the browser's address bar into the prompt Claude Code shows.
  3. Check it: claude mcp get yuha shows it connected, and /mcp lists its nine tools.

Check and disconnect

Check it worked: ask "What should I do today and why?" and watch Claude Code call YUHA Coach's tools.

To disconnect: sign out with claude mcp logout yuha, then remove it with claude mcp remove yuha. Sign out first, so YUHA ends the connection on its side too.

Claude Code's guide: Connect Claude Code to tools via MCP.

Claude Code plugin

The plugin comes after the beta. Its repository goes public when YUHA Coach opens to everyone. Until then, these commands find nothing.

Install it

  1. In Claude Code, run /plugin marketplace add yuha-app/claude-plugin
  2. Then run /plugin install yuha-coach@yuha-app
  3. The first time a tool is used, Claude Code runs the same sign-in as above.

It is the same server as the command above, with a short guide that helps Claude choose the right tool.

Check and disconnect

Check it worked: /mcp lists YUHA Coach's nine tools.

To disconnect: sign out with /mcp, then uninstall the plugin with /plugin. Or in YUHA, open Account, then Connected apps, and click Disconnect.

ChatGPT

This uses developer mode. Custom connectors are not on every ChatGPT plan, and in a business workspace an admin may have to turn them on first. These steps follow ChatGPT's own documentation. YUHA has not walked through them yet.

Turn on developer mode

  1. Open Settings, then Connectors, then Advanced, and switch Developer mode on.

Create the connector

  1. Back in Connectors, click Create.
  2. Name it YUHA Coach, paste https://yuha.app/mcp as the server URL, choose OAuth for authentication, confirm you trust the provider, and create it.

Sign in and allow

  1. ChatGPT opens YUHA's sign-in. Sign in, tick the groups and approve.

Switch it on in a chat

  1. In a conversation, open the + menu, then Connectors, and switch YUHA Coach on.

Check and disconnect

Check it worked: ask "What should I do today and why?" The answer names YUHA Coach as its source.

To disconnect: remove the connector in Settings, then Connectors. Or in YUHA, open Account, then Connected apps, and click Disconnect.

ChatGPT's guide is in its help center, under Connectors in ChatGPT.

Codex

This covers the Codex CLI, the IDE extension and the app. These steps follow Codex's own documentation. YUHA has not walked through them yet.

Add the server

  1. In a terminal, run:
    codex mcp add yuha --url https://yuha.app/mcp

    Or, instead of step 1, add this to ~/.codex/config.toml:

    [mcp_servers.yuha]
    url = "https://yuha.app/mcp"

Sign in and allow

  1. Then run codex mcp login yuha. Sign in to YUHA in your browser, tick the groups and approve.
  2. Check it: codex mcp list shows yuha as signed in.

Check and disconnect

Check it worked: ask "What should I do today and why?" and watch Codex call YUHA Coach's tools.

To disconnect: sign out with codex mcp logout yuha. Or in YUHA, open Account, then Connected apps, and click Disconnect.

Codex's guide: Model Context Protocol in Codex.

Gemini

These steps follow Google's own documentation. YUHA has not walked through them yet. Gemini works on request. The Gemini app's custom apps and Gemini Enterprise ask for a client that YUHA registers for them in advance.

Ask YUHA for a client

  1. Write to us from the Contact page and say which Gemini you use.
  2. We register it and send you the details to enter under Connected apps in Gemini.

Sign in and allow

  1. From there, the sign-in and the permission page are the same as everywhere else.

Check and disconnect

Check it worked: ask "What should I do today and why?" The answer names YUHA Coach as its source.

To disconnect: remove YUHA Coach from Gemini's connected apps. Or in YUHA, open Account, then Connected apps, and click Disconnect.

Google's guide: OAuth for connected apps.

Other assistants

Any assistant that speaks MCP over HTTPS with sign-in can use https://yuha.app/mcp.

Add the address

  1. Add https://yuha.app/mcp as a server in your assistant.
  2. Let it register itself as a client. If it asks for a client ID instead, write to us.

Sign in and allow

  1. Sign in to YUHA, tick the groups and approve.

Check and disconnect

Check it worked: ask "What should I do today and why?" and look for YUHA Coach as the source.

To disconnect: remove it in your assistant. Or in YUHA, open Account, then Connected apps, and click Disconnect.

About the connector

Where it works

Claude on the web and the desktop app
Status: In the beta. How: add a custom connector, steps above.
Claude Code
Status: In the beta. How: one command, steps above.
Claude Code plugin
Status: Coming after the beta. How: two slash commands, steps above.
ChatGPT
Status: Documented by ChatGPT, not yet walked through by YUHA. How: developer mode, steps above.
Codex (the CLI, IDE extension and app)
Status: Documented by Codex, not yet walked through by YUHA. How: one command or a config entry, steps above.
Gemini
Status: On request, not yet walked through by YUHA. How: Gemini needs a client YUHA registers for it, so write to us. Steps above.
Any other assistant that speaks MCP with sign-in (OAuth)
Status: Likely. How: the same address. It must register itself as a client.

The three "not yet walked through" rows follow the vendor's own documentation. We will mark them as checked once a runner on YUHA has done them.

What it can read

Nine tools that only read, in five groups. On the permission page you can turn off any group except the first.

While Strava is connected to YUHA, the connector refuses every request, because of Strava's terms for its data. Disconnecting Strava in Sources lifts it. The one exception is an account whose holder has asked YUHA in writing to allow it.

Today and your coach

  • Today with YUHA Coach
  • Connected sources

Your plan and goals

  • Training plan
  • Plan progress
  • Goals
  • Upcoming plan

Your history

  • History and insights
  • Activities

Your club runs

  • The club runs inside Upcoming plan: the ones you are going to and your clubs' next runs

Races

  • Race guide

Permissions, in YUHA's hands

You choose the five groups on YUHA's permission page when you sign in. You can switch a group off at any time in YUHA, under Account, then Connected apps. It takes effect on your assistant's next question. To allow more, connect again from your assistant. Nothing an assistant asks for is written to YUHA. Section 10 of the Privacy Policy says what YUHA keeps.

If it does not work

  • Refused at the first step. YUHA shows why on its own page, with a button back to your assistant: the beta has not reached your account yet, or Strava is connected. Disconnect Strava in Sources and it works again.
  • Claude says the client is unknown. Remove the connector and add it again, choosing "Register automatically" under OAuth client.
  • The assistant says it is not allowed to read something. That group is off. Connect again from the assistant to allow it.
  • A token has expired. The assistant signs in again by itself. If it cannot, disconnect and connect again.

Disconnect

In YUHA, open Account, then Connected apps. There you can switch a group off for an app, or disconnect it. You can also remove YUHA from your assistant's own connectors page. Either way it stops reading at once.

Questions? Email hello@yuha.app. See also the Privacy Policy.

YYUHA

The Readiness Coach for Runners. Built on your data, on iPhone, Android and the web.

YUHA for iPhone Download YUHA on the App Store YUHA for Android Get YUHA on Google Play

Product

Features YUHA Coach Pricing NYRR 9+1 Tracker Run Clubs Races Share your run

Company

About FAQs Contact

Legal

Privacy Policy Terms of Service
© 2026 YUHA HEALTH LLC. All rights reserved.