$cd ../integrations/
IntegrationSmart Home

Media Server Copilot: Plex & Jellyfin

Connect OpenClaw to your self-hosted media libraries. Ask for movie recommendations, check what's playing, or trigger downloads via natural language.

intro.md

The Smart Home DJ

Instead of manually scrolling through hundreds of gigabytes of media on your NAS, you can hook OpenClaw up to your media stack REST APIs. Chat on Telegram or WhatsApp: "Did we finish watching Shogun yet? If not, cast the next episode to the Living Room."

tokens.md

1. Prerequisites

  • β€’A running instance of Plex Media Server or Jellyfin.
  • β€’Your Server's IP address (e.g., 192.168.1.100).
  • β€’An API Key or Authentication Token.

2. Fetching your Tokens

For Plex
  1. 1.Sign in to Plex Web App.
  2. 2.Navigate to any library item and click 'Get Info' -> 'View XML'.
  3. 3.Look at the URL in your browser; copy the string after ?X-Plex-Token=.
For Jellyfin
  1. 1.Go to the Jellyfin Dashboard.
  2. 2.Under 'Advanced', click 'API Keys'.
  3. 3.Generate a new key and name it 'OpenClaw Agent'.
install.sh

3. Installing the Media MCP Skill

The community has built an excellent bridge script that unifies both Plex and Jellyfin polling into standard MCP tool calls.

npx -y @clawdhub/mcp-media-server-bridge --install
prompts.md

4. What Can It Do?

Library Intelligence
  • β€’What unwatched Sci-Fi movies do I have that are less than 2 hours long?
  • β€’List all the anime shows I added this month.
Session Control
  • β€’Who is currently streaming from my server right now and what are they watching?
  • β€’Stop the stream playing on 'Kids-iPad' immediately.
πŸ’‘ Pro Tip: For the ultimate setup, combine this skill with the mcp-arr-stack plugin. This allows the AI to realize a movie isn't on your Plex yet, and automatically send a request ticket to Radarr/Sonarr to fetch it for you!

❓ FAQ

Q1. Does it work with both Plex and Jellyfin?

Yes. The community MCP bridge script supports both. You configure whichever you use (or both) in your config.yaml.

Q2. Can I control playback on other devices?

Yes. It can cast to Chromecast, AirPlay, and any Plex/Jellyfin client. Just say 'play X on Living Room TV'.

Q3. Does it integrate with Radarr/Sonarr?

Yes, via the optional mcp-arr-stack plugin. The AI can request missing movies/shows to be downloaded automatically.
← Back to Integrations