Skip to main content

​
Overview

OneCLI connects AI agents to YouTube through Google’s OAuth flow. Agents can search for videos, list channel content, manage playlists, and read analytics data. The gateway injects OAuth credentials into requests to the YouTube Data API automatically. This is useful for agents that manage video content, curate playlists, monitor channel performance, or gather video metadata.

​
Setup

1

Go to Connections

Open the OneCLI dashboard and navigate to Connections > YouTube.
2

Authorize

Click Connect YouTube. You’ll be redirected to Google to authorize OneCLI. Review the permissions and click Allow.

​
What agents can do

  • Search for videos by keyword, topic, or channel
  • List videos on a channel with metadata (title, description, publish date, view count)
  • Get detailed video information (duration, tags, category, thumbnail URLs)
  • Create, update, and delete playlists
  • Add and remove videos from playlists
  • Read channel analytics (views, watch time, subscribers gained/lost)
  • List and read video comments
  • Post comments on videos
  • Read video captions and transcripts
  • List channel subscriptions

​
Controlling access

Access is per agent: grant the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization rules add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches YouTube.