YouTube Creator MCP
mcp-name: io.github.wmarceau/youtube-creator
YouTube automation tools for Claude via MCP (Model Context Protocol). Upload videos, manage Shorts, track analytics, and engage with comments.
Features
- Upload Videos: Upload with title, description, tags, thumbnails
- YouTube Shorts: Upload vertical videos with automatic #Shorts tagging
- Schedule Videos: Schedule uploads for future publication
- Analytics: Get views, likes, watch time, subscriber gains
- Playlists: Create playlists and add videos
- Comments: Read and reply to comments
- Channel Stats: Track subscriber count and total views
Installation
pip install youtube-creator-mcp
Setup
1. Enable YouTube Data API
- Go to Google Cloud Console
- Create or select a project
- Enable YouTube Data API v3
- Enable YouTube Analytics API
2. Create OAuth Credentials
- Go to APIs & Services > Credentials
- Click Create Credentials > OAuth client ID
- Select Desktop app
- Download the JSON file
- Save as
~/.google/youtube_credentials.json
3. First Run (Authentication)
On first use, you'll be prompted to authenticate via browser. The token is saved for future use.
Tools
| Tool | Description |
|---|---|
upload_video |
Upload video with metadata and thumbnail |
upload_short |
Upload YouTube Short (vertical, <60s) |
update_video_metadata |
Update title/description/tags |
get_video_analytics |
Get performance metrics |
get_channel_stats |
Subscriber count, total views |
schedule_video |
Upload and schedule for later |
add_to_playlist |
Add video to playlist |
list_playlists |
List channel playlists |
create_playlist |
Create new playlist |
get_comments |
Get video comments |
reply_to_comment |
Reply to a comment |
Usage Examples
Upload a Video
{
"tool": "upload_video",
"arguments": {
"video_path": "/path/to/video.mp4",
"title": "5 Fitness Tips You Need to Know",
"description": "In this video, I share my top 5 fitness tips...",
"tags": ["fitness", "workout", "health", "tips"],
"privacy": "public",
"category": "howto_style"
}
}
Upload a Short
{
"tool": "upload_short",
"arguments": {
"video_path": "/path/to/short.mp4",
"title": "Quick Workout Tip",
"description": "Save this for your next gym session!",
"tags": ["fitness", "shorts", "workout"],
"privacy": "public"
}
}
Get Analytics
{
"tool": "get_video_analytics",
"arguments": {
"video_id": "dQw4w9WgXcQ"
}
}
Video Categories
| Category Key | Description |
|---|---|
film_animation |
Film & Animation |
music |
Music |
pets_animals |
Pets & Animals |
sports |
Sports |
gaming |
Gaming |
people_blogs |
People & Blogs (default) |
entertainment |
Entertainment |
howto_style |
Howto & Style |
education |
Education |
science_tech |
Science & Technology |
Environment Variables
| Variable | Required | Description |
|---|---|---|
YOUTUBE_CREDENTIALS_PATH |
Yes | Path to OAuth client secrets JSON |
YOUTUBE_TOKEN_PATH |
No | Token storage path (default: ~/.google/youtube_token.pickle) |
Claude Desktop Configuration
Add to your Claude Desktop config:
{
"mcpServers": {
"youtube-creator": {
"command": "youtube-creator-mcp",
"env": {
"YOUTUBE_CREDENTIALS_PATH": "/path/to/credentials.json"
}
}
}
}
License
MIT
Metadata
Release files for youtube-creator-mcp 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| youtube_creator_mcp-1.0.1.tar.gz | 9.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| youtube_creator_mcp-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.5 kB
Release files / youtube_creator_mcp-1.0.1.tar.gz
| Download URL | youtube_creator_mcp-1.0.1.tar.gz |
|---|---|
| Size | 9.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bf11d768468484d562d8468a774bc987fe5f3678992ae0a939ba938da178c54c
|
|
BLAKE2b-256 checksum How to use checksums |
41bb340eb4ec33c33db58d7b6a27b80cc0cf1b717d71833d4614e6fdc4905c2d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / youtube_creator_mcp-1.0.1-py3-none-any.whl
| Download URL | youtube_creator_mcp-1.0.1-py3-none-any.whl |
|---|---|
| Size | 10.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a967ad0d34ab84762446c67f5572d8a5e67393bcd5aa8fdcb89d4583e557984e
|
|
BLAKE2b-256 checksum How to use checksums |
26448d8f399b79301436ae5e47b42b178c20fe732880225a4dabafa773d8244d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|