> ## Documentation Index
> Fetch the complete documentation index at: https://docs-hub.magicmealkits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting YouTube

> How to add YouTube to the hub so Claude can look up channels, videos, comments and what is trending, and analyse your own channel. Step by step, with a picture of each screen.

From v0.34.0 the hub connects YouTube. Once it is connected, Claude can look up
channels and videos, see what is trending, and analyse your own channel's views
and watch time.

YouTube is added separately from your Google accounts, but it signs in with
Google and uses the Google OAuth client you already registered. There is
nothing new to create.

<Note>
  For now the hub asks YouTube for **view access only**, so it cannot upload,
  edit or delete anything yet. Support for that is planned, and this page will
  say so when it arrives.
</Note>

The pictures below show the Korean admin screen. The buttons are in the same
places in English.

## Add the account

<Steps>
  <Step title="Open Accounts and press Add account">
    In the admin screen, open **Accounts** and press **Add account** at the top
    right.

    <Frame>
      <img src="https://mintcdn.com/mcp-hub/q2XBbJpuYR58EtXA/assets/youtube/01-add-account.png?fit=max&auto=format&n=q2XBbJpuYR58EtXA&q=85&s=221e44df3e46311de9b2d392d6916de9" alt="The Accounts screen, with a red circle drawn around the Add account button at the top right" width="1148" height="1038" data-path="assets/youtube/01-add-account.png" />
    </Frame>
  </Step>

  <Step title="Choose YouTube and press Add account">
    Under **Signs in with**, press the circle next to **YouTube**. The account
    name fills in as `youtube`, and **OAuth client** already has the one your
    Google accounts use. Leave both as they are in most cases.

    Press **Add account** at the bottom.

    <Frame>
      <img src="https://mintcdn.com/mcp-hub/q2XBbJpuYR58EtXA/assets/youtube/02-choose-youtube.png?fit=max&auto=format&n=q2XBbJpuYR58EtXA&q=85&s=12af85dfa4f9fb25788614611adb419e" alt="The Add account screen with the YouTube card selected, the account name youtube and an OAuth client shown, and the Add account button marked" width="1176" height="1017" data-path="assets/youtube/02-choose-youtube.png" />
    </Frame>
  </Step>

  <Step title="Press Connect now">
    When the screen says the account was added, press **Connect now**. Google's
    sign-in page opens.

    <Frame>
      <img src="https://mintcdn.com/mcp-hub/q2XBbJpuYR58EtXA/assets/youtube/03-connect-now.png?fit=max&auto=format&n=q2XBbJpuYR58EtXA&q=85&s=c4b500863b3d027cca4a2d6bf26aa366" alt="The screen saying the youtube account was added, with the Connect now button marked" width="1176" height="1017" data-path="assets/youtube/03-connect-now.png" />
    </Frame>
  </Step>

  <Step title="Choose your Google account">
    Choose the Google account that owns your YouTube channel.

    <Frame>
      <img src="https://mintcdn.com/mcp-hub/q2XBbJpuYR58EtXA/assets/youtube/04-choose-google-account.png?fit=max&auto=format&n=q2XBbJpuYR58EtXA&q=85&s=57b86de253c8cee511379f71b3568445" alt="Google's account chooser with a red box around the first account and the other accounts blurred" width="1176" height="1017" data-path="assets/youtube/04-choose-google-account.png" />
    </Frame>
  </Step>

  <Step title="Choose the account that has the channel">
    If your Google account has a brand account under it, Google asks once more
    which one to continue as. Choose the one that holds the YouTube channel you
    want analysed. If the channel lives on a brand account, choose the brand
    account, or your channel's analytics will look at the wrong one. If this
    screen does not appear, skip it.

    <Frame>
      <img src="https://mintcdn.com/mcp-hub/q2XBbJpuYR58EtXA/assets/youtube/05-choose-channel.png?fit=max&auto=format&n=q2XBbJpuYR58EtXA&q=85&s=13e7b7507150402e71ec7562416664db" alt="Google's screen for choosing your account or a brand account, with a red box around the first row" width="1176" height="1017" data-path="assets/youtube/05-choose-channel.png" />
    </Frame>
  </Step>

  <Step title="Continue past the unverified-app warning">
    Google warns that it has not verified this app. The app is the OAuth client
    you made yourself, so this is expected. Press **Advanced**, then the link at
    the bottom that starts with **Go to**.

    <Frame>
      <img src="https://mintcdn.com/mcp-hub/q2XBbJpuYR58EtXA/assets/youtube/06-unverified-advanced.png?fit=max&auto=format&n=q2XBbJpuYR58EtXA&q=85&s=d42e112f791ec70e30cddf48779abaaa" alt="The Google hasn't verified this app warning, with red circles around Advanced and the link at the bottom" width="1176" height="1017" data-path="assets/youtube/06-unverified-advanced.png" />
    </Frame>
  </Step>

  <Step title="Press Continue">
    On the screen saying you are signing back in, press **Continue**.

    <Frame>
      <img src="https://mintcdn.com/mcp-hub/q2XBbJpuYR58EtXA/assets/youtube/07-continue.png?fit=max&auto=format&n=q2XBbJpuYR58EtXA&q=85&s=bd270dc4c23411df896f9d8055814925" alt="The You're signing back in screen with the Continue button marked" width="1176" height="1017" data-path="assets/youtube/07-continue.png" />
    </Frame>
  </Step>

  <Step title="Check the access and press Continue">
    This screen shows what the hub will be allowed to do. Press **Continue**
    and you are back in the hub.

    <Frame>
      <img src="https://mintcdn.com/mcp-hub/q2XBbJpuYR58EtXA/assets/youtube/08-consent.png?fit=max&auto=format&n=q2XBbJpuYR58EtXA&q=85&s=787f908da9daba5afe44871a5b5bdb97" alt="Google's access request screen with the Continue button at the bottom marked" width="1176" height="1017" data-path="assets/youtube/08-consent.png" />
    </Frame>
  </Step>

  <Step title="Check that it says connected">
    You are done when the `youtube` account shows as **connected** on the
    **Accounts** screen.

    <Frame>
      <img src="https://mintcdn.com/mcp-hub/q2XBbJpuYR58EtXA/assets/youtube/09-connected.png?fit=max&auto=format&n=q2XBbJpuYR58EtXA&q=85&s=18f8f9b18a18fe486fb3bf427c05330b" alt="The Accounts screen with a red box around the youtube account row, marked as connected" width="1176" height="1017" data-path="assets/youtube/09-connected.png" />
    </Frame>
  </Step>

  <Step title="Refresh Claude's tool list">
    Claude keeps its own copy of the tool list and does not notice a new
    account by itself. [Refresh Claude's tool list](/refresh-tools-list), then
    ask in a new conversation.
  </Step>
</Steps>

## Reading comments as well

To read comments through a sign-in, YouTube demands permission to edit and
delete your videos and comments too. The hub does not take that permission.
It reads comments with an API key for public data instead. Without a key,
everything but comments works.

To add comments, create an API key in the Google Cloud console, restrict it to
the YouTube Data API v3, then open the `youtube` account in the admin screen and
paste it under **YouTube API key (optional)**.

## When it says YouTube is turned off

If the YouTube API is off in the Google Cloud project that holds your OAuth
client, Claude says so and passes along a link to turn it on. Open the link,
turn it on, and ask again after a few minutes. It is free, and nothing else
changes.
