# YouTube

> Connect YouTube so your AI can report on your channels' views, watch time, subscribers, top videos and traffic sources.

Connect YouTube (shown in the catalog as **YouTube Analytics**) and your AI can read analytics for the channels your Google login manages. Plugsight only reads: it never uploads, edits or deletes videos, comments or channel settings.


> [!IMPORTANT]
> Google is still reviewing the YouTube permission. Until Google approves it, YouTube isn't offered to everyone and may not appear in your **Connector catalog**.


## What your AI can do

- **List channels**: each channel with its subscribers, total views and number of videos.
- **Channel report** for any period: views, watch time, average view duration, subscribers gained and lost, likes, comments and shares, with totals. The report can be split by:
  - day or month (trends)
  - video (top videos, with titles)
  - country
  - device
  - traffic source (search, suggested, external and so on)
  - playback location
  - subscribed status (subscribers vs non-subscribers)
  - age and gender (share of viewers)
- **List videos**: a channel's uploads, newest first, with publish date, length, views, likes, comments and link. It can search by title.

### Example questions

- "How did my channel do last month compared with the month before?"
- "Which ten videos got the most watch time in the last 90 days?"
- "Where do my viewers come from: search, suggested videos or outside YouTube?"
- "How many subscribers did I gain and lose each month this year?"
- "What share of my viewers are 25–34?"
- "List my latest uploads and how many views each has."

## What you need

- A **Pro** or **Agency** plan, or the Free plan to try it: Free includes 1 marketing connection and 25 marketing tool calls a month. See [Plans](https://docs.plugsight.app/get-started/plans.md).
- The Google account that manages your YouTube channel.

## Connect YouTube

1. Open **Connections** and click **Add connection**.
2. Choose **YouTube Analytics**.
3. Read **What happens next** and click **Continue to Google**.
4. Choose the Google account that manages your channel.
5. If Google says **"Google hasn't verified this app"**, click **Advanced**, then **Go to Plugsight (unsafe)**.
6. Google asks: "View your YouTube account". Tick the box and continue.
7. You're back on **Connections**, with a message such as "Connected you@example.com: 1 YouTube channel."

Then add the connection to an MCP server and [refresh the tools list](https://docs.plugsight.app/ai-apps/refresh-tools.md) in your AI app.

To choose which channels your AI can see, click **Show sites & accounts** next to the connection. See [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md).

## What it can and can't change

YouTube is **read-only**, and Google's permission is read-only too.

## Limits

- Reports default to the last 28 days. Other presets: last 7, 30, 90 or 365 days, this month, last month, this year, last year, or exact dates.
- Reports and video lists return up to 200 rows (25 by default).
- YouTube allows only some figures with some splits. Splits by traffic source, device or playback location show views and watch time; the age and gender split shows the share of viewers.
- If a channel hides its subscriber count, the count isn't shown.
- If you have one channel, your AI uses it without asking. With several, it needs the channel name or id.

## Troubleshooting


### This Google service is coming soon.

**What it means:** Google hasn't finished reviewing the permission, so YouTube isn't open to everyone yet.

**How to fix it:** Nothing to do for now. It will appear in the **Connector catalog** once Google approves it.


### "This login doesn't reach anything yet."

**What it means:** The Google account you used doesn't manage a YouTube channel.

**How to fix it:** Connect again and choose the account that manages the channel, then click **Refresh list**.

### This MCP reaches 2 channels; pass one of: …

**What it means:** You have several channels and your AI didn't say which.

**How to fix it:** Name the channel in your question.

### YouTube access wasn't granted. Tick the permission and try again.

**What it means:** The permission box on Google's screen wasn't ticked.

**How to fix it:** Connect again and tick the box.

For other sign-in messages, see the troubleshooting section of [Google Ads](https://docs.plugsight.app/connectors/google-ads.md).

## Related articles

- [How your AI analyses marketing data](https://docs.plugsight.app/connectors/marketing-data.md)
- [Google Analytics 4](https://docs.plugsight.app/connectors/google-analytics-4.md)
- [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md)
- [YouTube tools](https://docs.plugsight.app/developers/youtube-tools.md)

---

Web version: https://docs.plugsight.app/connectors/youtube
