youtube-mcp
Provides tools for managing a YouTube channel via the YouTube Data API v3, including uploading videos, editing metadata and privacy, setting thumbnails, inspecting channel and video statistics, and managing playlists.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
youtube-mcp
MCP server for managing a YouTube channel with the YouTube Data API v3: upload videos, edit metadata, set thumbnails, inspect channel/video stats, and manage playlists — with OAuth login and automatic token refresh built into the server, so anyone can connect it to their own Google account.
Tools
Tool | Description |
| One-time OAuth consent (loopback flow); stores refresh token locally (0600) |
| Check/refresh authorization, shows connected channel |
| Remove the stored token |
| Channel title, ID, description, statistics |
| Uploaded videos (paginated): title, URL, duration, privacy, views |
| Full details for one video |
| Resumable upload with title/description/tags/privacy/schedule |
| Patch metadata or privacy of an owned video |
| Set a custom thumbnail image |
| Permanently delete a video (destructive) |
| List channel playlists |
| Add a video to a playlist |
| Remove a video from a playlist (keeps the video) |
Related MCP server: YouTube MCP
Install
pip install git+https://github.com/ZorionTen/youtube-mcp.git
# or from a clone:
git clone https://github.com/ZorionTen/youtube-mcp.git && cd youtube-mcp
pip install -e .Requires Python 3.10+.
Google Cloud setup (once, ~3 minutes)
Create a project at console.cloud.google.com
Enable the API: APIs & Services → Library → YouTube Data API v3 → Enable
Configure consent: APIs & Services → OAuth consent screen → External → fill App name + support email → add test users if in Testing
Add scopes: OAuth consent screen → Data Access → add
.../auth/youtubeand.../auth/youtube.uploadCreate credentials: APIs & Services → Credentials → Create credentials → OAuth client ID → Desktop app → download JSON
Provide the credentials to the server in either way:
# Option A: environment variables
export YOUTUBE_CLIENT_ID="....apps.googleusercontent.com"
export YOUTUBE_CLIENT_SECRET="GOCSPX-..."
# Option B: secrets file (Google's downloaded JSON works as-is)
export YOUTUBE_CLIENT_SECRET_FILE=~/Downloads/client_secret.json
# or drop it at ~/.config/youtube-mcp/client_secret.jsonThen authorize once:
youtube-mcp-auth # or: python -m youtube_mcp.auth
# your browser opens → sign in → AllowThe refresh token is saved to ~/.config/youtube-mcp/token.json (mode 0600, git-ignored by any sane .gitignore). From then on the server refreshes access tokens automatically on every call; if the token is revoked, tools return an error telling you to re-run login.
Client configuration
Claude Code
claude mcp add youtube -- npx -y youtube-mcp # after pip install, or:
claude mcp add youtube -- youtube-mcpOpenCode (opencode.jsonc)
{
"mcp": {
"youtube": {
"type": "local",
"command": ["youtube-mcp"],
"enabled": true
}
}
}Quota
YouTube Data API v3 default quota is 10,000 units/day; a video upload costs 1,600 units (≈6 uploads/day). Reads cost 1 unit each. yt_auth_status reports quota errors with guidance when hit.
Development
pip install -e .
python -m pytest # unit tests (no network)
npx @modelcontextprotocol/inspector youtube-mcp # interactive testingLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Publish to your YouTube and Instagram accounts: schedule posts, read analytics and manage comments.
YouTube discovery, transcripts, library search, and monitors with API keys or OAuth.
The YouTube autopilot: plan, write and schedule YouTube videos, and upload from your machine.
Hosted MCP for YouTube Studio: uploads, metadata, playlists, comments, analytics, captions.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interacting with YouTube Data API v3 through MCP tools (get-video, get-channel, get-latest-video) and bundled UI apps for video and channel profiles.4ISC
- FlicenseNot gradedqualityDmaintenanceEnables YouTube video upload, metadata updates, thumbnail management, stats retrieval, and analytics via the YouTube Data API v3 and Analytics API using OAuth 2.0.-
- AlicenseNot gradedqualityCmaintenanceEnables searching and retrieving YouTube videos, channels, playlists, comments and transcripts through the YouTube Data API v3 using an API key. Provides read-only tools for search, video and channel details, playlist items, comments, trending videos and plain-text caption transcripts.69 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables multi-user management of channels, videos, comments, playlists, and analytics through Google's official APIs, including resumable uploads and OAuth-secured account access.MIT