YouTube-MCP
Description
# YouTube-MCP MCP(Model Context Protocol) server for Youtube search, transcript etc built using Java MCP SDK and Spring AI. For transcript extraction alone Javascript is used. ## Exposed Tools - youtube_search: Search for videos on YouTube using a query string. -…
About
# YouTube-MCP MCP(Model Context Protocol) server for Youtube search, transcript etc built using Java MCP SDK and Spring AI. For transcript extraction alone Javascript is used. ## Exposed Tools - youtube_search: Search for videos on YouTube using a query string. - youtube_transcript: Get transcript for a YouTube video…
Details
- Author
- CodeWizzard01
- Downloads
- 180
- Categories
- Media
Jump to
- Search YouTube videos by query string
- Extract transcripts from videos by ID
- Get video details and metadata
- Retrieve thumbnail
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
YouTube-MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run the server as a Docker container with the YOUTUBE_API_KEY environment variable, or from an IDE using Java 24 and Maven. Connect to an MCP host by adding an SSE endpoint (http://localhost:8085) or a stdio command (java -jar youtube-mcp.jar) to the MCP config file.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"youtube-mcp": {
"youtube-mcp-server-codewizzard01": {
"command": "docker",
"args": [
"run",
"-e",
"YOUTUBE_API_KEY=<your_api_key_here>",
"-p",
"8085:8080",
"codewizard01/youtube-mcp:latest"
]
}
}
}
}McpServers
{
"youtube-mcp-server-codewizzard01": {
"command": "docker",
"args": [
"run",
"-e",
"YOUTUBE_API_KEY=<your_api_key_here>",
"-p",
"8085:8080",
"codewizard01/youtube-mcp:latest"
]
}
}YouTube-MCP
MCP(Model Context Protocol) server for Youtube search, transcript etc built using Java MCP SDK and Spring AI. For transcript extraction alone Javascript is used.
Exposed Tools
- youtube_search: Search for videos on YouTube using a query string.
- youtube_transcript: Get transcript for a YouTube video by video ID.
- youtube_video_details: Get details of a YouTube video using its video ID.
- youtube_video_thumbnails: Get thumbnail URLs for a YouTube video by video ID.
- youtube_video_comments: List comments for a YouTube video by video ID. (Public comments only)
- youtube_channel_info: Get information about a YouTube channel by channel ID.
- youtube_channel_playlists: List playlists for a YouTube channel by channel ID.
- youtube_channel_sections: List channel sections (shelves) for a YouTube channel by channel ID.
- youtube_playlist_items: List videos in a YouTube playlist by playlist ID.
- youtube_activities: List activities for a YouTube channel by channel ID. (Public activities only)
- youtube_video_categories: List video categories available in a region.
Running MCP Server and then connecting to it from MCP host
Running MCP Server as docker container
Docker image is available on docker hub - https://hub.docker.com/r/codewizard01/youtube-mcp
Prerequisites
- Dockerdocker run -e YOUTUBE_API_KEY=<your_api_key_here> -p 8085:8080 codewizard01/youtube-mcp:latest
Then add the following to your mcp config file to interact via SSE:
{
"youtube": {
"mcp_server": "http://localhost:8085"
}
}
Running the MCP server from an IDE
Prerequisites
- Java 24 - Maven 3.8.1 - Node1. Clone the repository
2. Open the project in your IDE
3. Run the following command to build the project
mvn clean install
npm install
4. Run the following command to start the server
mvn spring-boot:run
5. The server will start on port 8080 by default. You can change the port in the application.properties file.
Interacting with the MCP server via standard input output
Enable the below commented properties in the application.properties file to enable standard input output.
```properties
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
