README.md
Control your yt-dlp web GUI from any AI assistant.
metube-mcp
MCP server for MeTube — control your yt-dlp web GUI from any AI assistant.
Tools
| Tool | Description |
|---|---|
metube_add_download |
Queue a video/audio download (URL, quality, format, folder) |
metube_list_downloads |
List queued, active, and completed downloads |
metube_delete_downloads |
Remove items from queue or history |
metube_start_downloads |
Start pending downloads |
metube_cancel_add |
Cancel current add operation |
metube_get_version |
Get MeTube and yt-dlp versions |
metube_cookie_status |
Check if cookies are configured |
metube_upload_cookies |
Upload cookies for authenticated downloads |
metube_delete_cookies |
Remove uploaded cookies |
Setup
Claude Code
{
"mcpServers": {
"metube": {
"command": "uvx",
"args": ["metube-mcp"],
"env": {
"METUBE_URL": "http://localhost:8081"
}
}
}
}
From source
{
"mcpServers": {
"metube": {
"command": "uvx",
"args": ["--from", "git+https://github.com/ishevchenko/metube-mcp", "metube-mcp"],
"env": {
"METUBE_URL": "http://localhost:8081"
}
}
}
}
Configuration
| Environment Variable | Default | Description |
|---|---|---|
METUBE_URL |
http://localhost:8081 |
MeTube instance URL |
Development
git clone https://github.com/ishevchenko/metube-mcp.git
cd metube-mcp
pip install -e .
METUBE_URL=http://localhost:8081 metube-mcp
License
MIT
Tools (9)
metube_add_downloadQueue a video/audio download.metube_list_downloadsList queued, active, and completed downloads.metube_delete_downloadsRemove items from queue or history.metube_start_downloadsStart pending downloads.metube_cancel_addCancel current add operation.metube_get_versionGet MeTube and yt-dlp versions.metube_cookie_statusCheck if cookies are configured.metube_upload_cookiesUpload cookies for authenticated downloads.metube_delete_cookiesRemove uploaded cookies.Environment Variables
METUBE_URLMeTube instance URLConfiguration
claude_desktop_config.json
{"mcpServers": {"metube": {"command": "uvx", "args": ["metube-mcp"], "env": {"METUBE_URL": "http://localhost:8081"}}}}Try it
→Queue a download for this video URL: [insert URL]
→List all my current and completed downloads in MeTube.
→Check if my authentication cookies are currently configured.
→Remove the completed downloads from my history.