YouTube MCP
Targeted at YouTube publishing, but the current slice only provides a transport shell and a health tool; there is no YouTube client, credential provider, or publishing operation yet.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
YouTube MCP
A Python MCP server for YouTube publishing, built from scratch under
portfolio-ops #285.
MIT licensed. Slice 1 supplies a transport shell and a health tool; Slice 2
adds an offline profile contract and credential-provider interface. Slice 3 adds guarded read tools through an injectable client port. No publishing
operation or live Google adapter is included.
Requires Python 3.11 or newer.
pip install .
youtube-mcp # stdio (default)
python -m youtube_mcp # equivalent
youtube-mcp --transport http # http://127.0.0.1:8000/mcpBoth modes construct the same FastMCP registry. health() returns
{"status": "ok"} without contacting Google. Startup needs no credentials.
Logs go to stderr; stdout is reserved for the stdio MCP protocol.
http means Streamable HTTP, not the legacy SSE transport.
HTTP accepts only literal loopback addresses (127.0.0.1 by default; ::1
is also supported). Wildcards, hostnames, and non-loopback addresses are rejected
before startup. Slice 1 has no caller-auth policy implementation or bypass flag,
so remote binding is always refused. Loopback has no caller authentication: use
only on a trusted local machine. Google OAuth will authorize Google operations;
it will not authenticate MCP callers. Future remote hosting needs a separate,
reviewed caller-auth policy. Do not expose this process through a proxy or tunnel.
The supported entry points enforce the bind guard; importing create_server()
is an embedding API, and an embedder owns its listener and access policy.
Development:
uv sync --locked --group dev
uv run ruff check .
uv run ruff format --check .
uv run pytestCI repeats lint and subprocess transport tests on Python 3.11 and 3.13 and runs Gitleaks against full git history. Tests start only local processes/listeners; no live Google service or credentials are used. Private hosting, IaC, Google setup, OAuth, and secret-store wiring are outside this repository slice.
Slice 2 adds the offline core contract in youtube_mcp.profiles. Construct a
Profile with profile_id, pinned channel_id, display label,
granted_scopes (full OAuth scope URLs), and an opaque credential_ref.
ProfileStore.resolve(profile_id) requires an exact explicit id and the
https://www.googleapis.com/auth/youtube.force-ssl grant. Labels/channel titles
never select a profile; a missing id never selects a default, even with one
configured profile. Duplicate ids are rejected. Scope sets are immutable snapshots.
The record contains no token fields. Keep token bytes outside profiles behind the
CredentialProvider protocol; InMemoryCredentialProvider is an offline fake
returning a redacted-repr Credential. Profile resolution returns only the pinned
record and does not call the provider. Adapters must use safe fixed-message errors
and omit credentials, references, and upstream error chains from diagnostics.
Redacted repr is defensive only: never serialize/log credential values or profile
records wholesale. References are opaque lookup keys, not credential material.
This slice adds no MCP tools, persistence, OAuth, 1Password, or Google calls.
Slice 3 exposes get_channel(profile_id), get_video(profile_id, video_id),
list_playlists(profile_id, page_token=None), and
list_playlist_items(profile_id, playlist_id, page_token=None) on both transports.
Every call requires an explicit profile id and checks channels.list(mine=true)
for exactly one channel matching that profile's pin. Video reads additionally
require snippet.channelId to match; missing, ambiguous, or foreign videos fail
closed. Playlist reads preserve the API page response and continuation token;
playlist items may include third-party videos and are not an ownership assertion.
Embedders inject Reads(ProfileStore(...), credential_provider, client_factory)
into create_server(reads). The factory receives only the selected credential;
its client implements list(resource, **parameters) for channels, videos,
playlists, and playlistItems (the corresponding Data API .list methods).
Adapters must omit credential material from diagnostics. No adapter or credential
configuration is loaded at startup; without injection the read tools fail closed.
Reads.require_owned_video is the reusable guard for later write slices; this
slice has no mutation port or mutation tool. Future writes must use the checked
profile/client context and must not switch accounts after checking ownership.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Streamable HTTP MCP server for Google Calendar and Sheets with OAuth login.
Minimal streamable HTTP MCP server used for owned-account registry connectivity tests.
MCP compatibility and transport verification server.
MCP compatibility and transport verification server.
Related MCP Servers
- AlicenseBqualityDmaintenanceLocal read-only MCP server for YouTube Data API v3 and YouTube Analytics API, enabling public video searches and OAuth-based private channel reads.9MIT
- FlicenseNot gradedqualityDmaintenanceA minimal MCP server over Streamable HTTP demonstrating the MCP protocol with tools for health checks, echo, and text reversal.-
- AlicenseBqualityBmaintenanceA local stdio MCP server that lets MCP clients inspect and operate a self-hosted ytptube HTTP API, with tools for health checks, queue/history management, archives, tasks, and presets while protecting credentials.288 npmMIT
- AlicenseAqualityCmaintenanceLocal YouTube MCP server for turning public video, channel, and playlist URLs into structured context, with bounded comment retrieval, timestamped captions, and owned-playlist management using your own Google Cloud credentials.17MIT