Remote YouTube

This MCP server provides YouTube video transcript extraction tools with OAuth authentication, enabling secure access for MCP clients to obtain and format transcripts using a remote API.

How to use

You can interact with this MCP server from any MCP client by calling its available tools. The server exposes a remote endpoint for transcript extraction and writing templates, secured with OAuth 2.0 authentication. Use the fetch_video_transcript tool to retrieve transcripts for YouTube videos and fetch_instructions to obtain writing templates such as blogs, social posts, or video chapters.

To start a session, your client will need to obtain a valid access token from the configured Auth0 domain and include it in requests to the MCP endpoint. Once authenticated, you can request a transcript by providing a YouTube URL or fetch predefined instruction templates to structure your outputs.

How to install

Prerequisites: you need Python 3.13 or newer. You also require an environment capable of running the MCP server (and network access to the OAuth provider). Ensure you have a compatible runtime and the package manager or runner described below ready.

# 1. Clone the repository
# (Replace the placeholder with the actual repository URL if you have one)
# git clone <repository-url>

# 2. Install dependencies
uv sync

# 3. Configure environment variables in a .env file
# AUTH0_DOMAIN=your-auth0-domain
# AUTH0_AUDIENCE=your-api-identifier # same as RESOURCE_SERVER_URL in this example
# RESOURCE_SERVER_URL=<your-server-public-url>/mcp

# 4. Run the server
uv run python main.py

Additional sections

Server URL and runtime details: The MCP endpoint is available at http://0.0.0.0:8000/mcp. The server is built to integrate with MCP clients that support ChatGPT and Claude-style prompts via OAuth 2.0 authentication.

Security considerations: The server relies on Auth0 for OAuth authentication. Ensure tokens are stored securely and transmitted only over HTTPS in production. Configure your client to request the appropriate scopes for transcript retrieval and template access.

Tools exposed by the server include transcript extraction and writing templates. Use fetch_video_transcript to retrieve and format transcripts from YouTube URLs, and fetch_instructions to obtain templates like write_blog_post, write_social_post, and write_video_chapters.

Available tools

fetch_video_transcript

Extracts and formats transcripts from a YouTube video given its URL.

fetch_instructions

Retrieves writing templates such as write_blog_post, write_social_post, and write_video_chapters.