catt-mcp
Use this MCP server to cast YouTube videos and other media to Chromecast/DLNA devices and control playback.
cast_youtube: Cast a YouTube video by URL or video ID.
cast_url: Cast any media URL (video, audio, stream).
cast_stop / cast_pause / cast_resume: Stop, pause, or resume the current cast.
cast_volume: Set the volume from 0 to 100.
cast_seek: Seek forward or backward by seconds.
cast_status / cast_info: Get current playback status and detailed media info.
cast_scan: Discover available Chromecast/DLNA devices on the network.
When Hyprland, playerctl, Firefox, and lz4 are available, it can also mirror the active Firefox tab to the TV and provide dual-screen sync (start, resync, stop, adjust offset).
Allows casting YouTube videos and arbitrary media URLs to Chromecast devices, with playback controls (pause, resume, stop, volume, seek, status) and device discovery.
Allows casting media to DLNA-compatible devices on the network, with device scanning and playback control.
Allows casting the video from the active Firefox tab to a TV, including dual-screen playback with synchronization on PC and TV.
Allows casting YouTube videos to a TV by URL or video ID, with playback control and status retrieval.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@catt-mcp cast youtube video https://youtu.be/dQw4w9WgXcQ to the TV"
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.
catt-mcp
MCP server for casting YouTube videos and media to Chromecast/DLNA devices via catt.
Exposes 15 tools covering YouTube casting, playback control, dual-screen sync, and device discovery.
Demo

Recorded on the real network with docs/demo/record.sh: a minimal MCP client (docs/demo/mcp_demo.py) starts the server over stdio with CATT_DEVICE in the environment, lists the tools and calls cast_scan (read-only). Private IP addresses are replaced with documentation addresses.
Related MCP server: YT-NINJA
Tools
Outil | Rôle |
| Caste une video YouTube sur la TV (URL ou ID de video) |
| Caste une URL quelconque (video, audio, stream) sur la TV |
| Arrete le cast en cours sur la TV |
| Met en pause le cast en cours |
| Reprend la lecture du cast |
| Regle le volume du cast (0-100) |
| Avance ou recule dans la video |
| Retourne le statut du cast en cours |
| Scanne les devices Chromecast/DLNA disponibles sur le reseau |
| Retourne les infos detaillees du media en cours |
| Caste la video de l'onglet actif de Firefox sur la TV (YouTube, Twitch, etc.) |
| Lance la video sur PC (Firefox) ET TV simultanement avec synchronisation (pour LightBeat) |
| Resynchronise PC et TV en relancant la TV a la position Firefox |
| Arrete le dual cast et le watcher de synchronisation |
| Ajuste le decalage TV (positif=TV en avance, negatif=TV en retard) |
YouTube ID extraction
_extract_video_id (URL watch?v=, youtu.be/, shorts/ or a bare 11-character ID, anything else rejected before it reaches catt/ADB) is deliberately duplicated in pylips-mcp (youtube_video, TV app with Premium account). Both servers stay installable on their own; each one tests its copy with the same table of cases (tests/test_youtube_id.py). Decision recorded on 2026-09-20.
Requirements
Python 3.10+
catt:
pip install cattyt-dlp:
pip install yt-dlpA Chromecast or DLNA-compatible device on the same network
lz4(optional, for cache compression):pip install lz4
Dual cast (Linux + Hyprland)
cast_browser, cast_browser_dual, cast_dual_resync, cast_dual_stop and
cast_dual_offset drive Firefox from the running desktop session. They are
advertised only when the required binaries are present:
Hyprland with
hyprctlinPATHplayerctlfor MPRIS playback controlFirefox holding the video to mirror
lz4(Python) to read Firefox's session cache
Without them the server starts normally and simply does not expose these five tools, instead of failing when they are called.
Installation en une ligne
uvx catt-mcp # depuis PyPI ; avant publication : uvx --from git+https://github.com/amineutron/catt-mcp catt-mcpConfiguration Claude Desktop / Claude Code (mcpServers) :
{ "catt": { "command": "uvx", "args": ["catt-mcp"], "env": { "CATT_DEVICE": "Living Room TV" } } }Setup
1. Install dependencies
pip install mcp catt yt-dlp2. Discover your device
catt scanNote the device name (e.g. 55OLED705/12, Living Room TV).
3. Configure
Copy config.example.yaml to config.yaml:
catt:
device: "55OLED705/12" # Name from catt scan4. Run
catt-mcp # installed (pip, uvx) ; `catt-mcp --help` lists the settings
python -m catt_mcp # same thing, from any environment where the package is installed
python server.py # from a clone, without installing (thin launcher, code in catt_mcp/)Or with environment variable:
CATT_DEVICE="55OLED705/12" catt-mcpThe code lives in the catt_mcp package (catt_mcp/server.py, catt_mcp/sync_watcher.py),
so it can be installed next to other MCP servers without module name clashes.
The dual-screen tools (dual_cast, dual_resync, dual_offset) drive the TV through
ADB and need its IP address. Set it with TV_HOST (or tv.host in config.yaml),
for example TV_HOST="192.0.2.10"; the built-in default is only a placeholder.
Claude Desktop Configuration
{
"mcpServers": {
"catt": {
"command": "python3",
"args": ["/path/to/catt-mcp/server.py"],
"env": {
"CATT_DEVICE": "55OLED705/12"
}
}
}
}License
MIT
Part of the Lyra ecosystem
Dépôt | Rôle |
assistant DevOps vocal, local par défaut (AGPL-3.0) | |
MCP : machines virtuelles KVM et sauvegardes | |
MCP + API + tableau de bord des tâches longues | |
hub PWA du homelab | |
MCP Philips Hue (fork de ThomasRohde/hue-mcp) | |
MCP TV Philips | |
MCP ampli Denon | |
MCP Chromecast et DLNA |
Available Tools
10 toolscast_infoARead-onlyIdempotent
Retourne les infos detaillees du media en cours
Inputs: no named parameters.
cast_pauseAIdempotent
Met en pause le cast en cours
Inputs: no named parameters.
cast_resumeBIdempotent
Reprend la lecture du cast
Inputs: no named parameters.
cast_scanARead-onlyIdempotent
Scanne les devices Chromecast/DLNA disponibles sur le reseau
Inputs: no named parameters.
cast_seekCIdempotent
Avance ou recule dans la video
Inputs: seconds (required).
cast_statusBRead-onlyIdempotent
Retourne le statut du cast en cours
Inputs: no named parameters.
cast_stopAIdempotent
Arrete le cast en cours sur la TV
Inputs: no named parameters.
cast_urlA
Caste une URL quelconque (video, audio, stream) sur la TV
Inputs: url (required).
cast_volumeAIdempotent
Regle le volume du cast (0-100)
Inputs: level (required).
cast_youtubeA
Caste une video YouTube sur la TV (URL ou ID de video)
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Most tools have clearly distinct purposes (stop, pause, resume, volume, seek, scan), but cast_status and cast_info could be confused since both return state-related information. cast_youtube and cast_url are similar but descriptions clarify the target type.
All tools follow a consistent cast_ prefix with lowercase snake_case. The pattern is uniform: cast_<action> or cast_<target>, making the set predictable and easy to navigate.
10 tools is well-scoped for a casting server, covering the essential actions without unnecessary bloat. Each tool earns its place in the workflow.
The set covers the full cast lifecycle: start, control, and query playback. Missing queue management or explicit device selection, but these are not core for basic casting operations.
Maintenance
Related MCP Connectors
Give your AI agent the power to cast to your home TV and control an interactive canvas. By ArdaBot.
YouTube transcripts, comments, video details, heatmaps, search, channels and playlists.
YouTube tools: X-ray any channel, research topics, find collabs, manage video projects.
Hand off whole tasks: videos, research, posts, web pages. Uses your own Chrome, computer and phone.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to control and automate your Chrome browser directly, leveraging existing login states and configurations for tasks like content analysis, semantic search across tabs, screenshots, network monitoring, and interactive operations.13MIT
- AlicenseBqualityDmaintenanceEnables AI-powered YouTube video analysis including transcript management, video summaries, chapter generation, keyword extraction, and playback control. Supports searching videos, retrieving channel/playlist information, and translating transcripts using Google Gemini AI.14MIT
- AlicenseBqualityAmaintenanceControl any smart TV with natural language — play Netflix/YouTube/Spotify by name, cast URLs, scene presets, multi-room audio, and multi-TV sync. Supports LG, Samsung, Android TV, Roku.2373 PyPI60MIT
- AlicenseAqualityCmaintenanceEnables AI to search for video streaming URLs and play them directly on Xiaomi TV or other Android TVs. Supports custom configurations for multiple devices.2103 PyPI26MIT