How do I use metube-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@metube-mcp download https://www.youtube.com/watch?v=dQw4w9WgXcQ in high quality" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

metube-mcp

by JungleM0nkey

Overview Schema Source Related Servers Discussions Admin

Python

Remote

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

Related MCP server: mcp-yt-dlp

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

Available Tools

9 tools

metube_add_downloadA

Queue a video or audio download in MeTube.

Args: url: Video/playlist URL to download (YouTube, Vimeo, etc.) quality: Download quality - "best", "1080", "720", "480", etc. format: Format selection - "any" (video+audio), "mp4", "mp3", "wav", "opus", etc. auto_start: Whether to start downloading immediately (default: true) folder: Subfolder within the download directory custom_name_prefix: Prefix for the downloaded filename playlist_item_limit: Max items to download from playlist (0 = all)

Name	Required	Default
`url`	Yes
`quality`	No	best
`format`	No	any
`auto_start`	No
`folder`	No
`custom_name_prefix`	No
`playlist_item_limit`	No

Output Schema

Name	Required	Description
`result`	Yes

metube_cancel_addA

Cancel the current add operation (useful for large playlists).

Name	Required	Description	Default
No parameters

Output Schema

Name	Required	Description
`result`	Yes

metube_cookie_statusA

Check if cookies are configured for authenticated downloads.

Name	Required	Description	Default
No parameters

Output Schema

Name	Required	Description
`result`	Yes

metube_delete_cookiesA

Remove uploaded cookies.

Name	Required	Description	Default
No parameters

Output Schema

Name	Required	Description
`result`	Yes

metube_delete_downloadsA

Delete downloads from the queue or completed list.

Args: ids: List of download IDs to delete where: Where to delete from - "queue" or "done"

Name	Required	Description	Default
`ids`	Yes
`where`	No		queue

Output Schema

Name	Required	Description
`result`	Yes

metube_get_versionA

Get MeTube and yt-dlp version information.

Name	Required	Description	Default
No parameters

Output Schema

Name	Required	Description
`result`	Yes

metube_list_downloadsA

List all downloads - queued, pending, and completed.

Returns the full download history with status, progress, and metadata for each item.

Name	Required	Description	Default
No parameters

Output Schema

Name	Required	Description
`result`	Yes

metube_start_downloadsA

Start pending downloads that were added with auto_start=false.

Args: ids: List of download IDs to start

Name	Required	Description	Default
`ids`	Yes

Output Schema

Name	Required	Description
`result`	Yes

metube_upload_cookiesB

Upload cookies for authenticated downloads (e.g., age-restricted content).

Args: cookies_content: Cookie file content in Netscape format

Name	Required	Description	Default
`cookies_content`	Yes

Output Schema

Name	Required	Description
`result`	Yes

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

9 tool updatesv0.1.0Apr 24, 2026
- First observedmetube_add_download
- First observedmetube_cancel_add
- First observedmetube_cookie_status
- First observedmetube_delete_cookies
- First observedmetube_delete_downloads
- First observedmetube_get_version
- First observedmetube_list_downloads
- First observedmetube_start_downloads
- First observedmetube_upload_cookies

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored 2026-04-24 08:15 across 9 tools

Disambiguation5/5

All tools have clearly distinct purposes: adding, cancelling adds, managing cookies, deleting downloads, listing, starting, and version checks. No overlap or ambiguity.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern in snake_case (e.g., add_download, cancel_add, list_downloads). The prefix 'metube_' is uniformly applied.

Tool Count5/5

With 9 tools, the set is well-scoped for a download manager, covering all core operations without being bloated or too sparse.

Completeness4/5

Covers essential CRUD-like operations for downloads and cookie management. Missing pause/resume, but these are non-critical; overall surface is sufficient for typical agent workflows.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

mcp-openai
io.github.AceDataCloud
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
AI & Machine Learning Image & Video Processing
11
https://openai.mcp.acedata.cloud/mcp
mcp-aichat
io.github.AceDataCloud
MCP server for AI dialogue using various LLM models via AceDataCloud
AI & Machine Learning
2
https://aichat.mcp.acedata.cloud/mcp
supportsheep
io.github.pooriaarab
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Customer Support Content Management Systems Marketing
1
https://supportsheep.com/api/v1/mcp
supportsheep
io.github.itsryanarmani
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Content Management Systems Marketing AI & Machine Learning
1
https://supportsheep.com/api/v1/mcp

Related MCP Servers

MCP YouTube Downloader
Multimedia Processing Entertainment & Media
lucassnts963
A
license
Not graded
quality
D
maintenance
MCP server for downloading videos and audio from YouTube and hundreds of other sites using yt-dlp.
Updated 5 months ago (2026-06-04 01:13 UTC)
MIT
mcp-yt-dlp
Entertainment & Media Multimedia Processing
pauloFroes
A
license
A
quality
D
maintenance
MCP server wrapping yt-dlp for downloading videos and audio from URLs, providing tools to check dependencies, retrieve video metadata, and perform downloads.
Updated 7 months ago (2026-03-29 13:36 UTC)
4
MIT
hoardline
Browser Automation Multimedia Processing Entertainment & Media
mitchboulay
A
license
Not graded
quality
C
maintenance
A self-hosted media downloader and converter MCP server that wraps yt-dlp and HandBrake, allowing AI assistants to download, convert, manage queues, and handle subscriptions.
Updated 11 days ago (2026-10-29 18:16 UTC)
MIT
yts-mcp
Web Scraping Entertainment & Media Multimedia Processing
josetonyp
F
license
Not graded
quality
D
maintenance
MCP server for fetching YouTube video transcripts and metadata using yt-dlp. It provides tools for transcript retrieval, subtitle listing, video info, and cookie management to bypass YouTube rate limits.
Updated 3 months ago (2026-08-07 00:23 UTC)
-

metube-mcp

Tools

Setup

Claude Code

From source

Configuration

Development

License

Available Tools

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MCP YouTube Downloader

mcp-yt-dlp

hoardline

yts-mcp