# Plex Media Library Search Server

Enable seamless searching and browsing of your Plex media libraries through an MCP server. Authenticate securely with Plex via OAuth or static tokens and retrieve rich metadata for movies, shows, mus…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add vyb1ng/plex-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list vyb1ng/plex-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get vyb1ng/plex-mcp search_plex

# Call a tool
npx -y @smithery/cli@latest tool call vyb1ng/plex-mcp search_plex '{}'
```

## Tools (22)

- `search_plex` — Search for movies, TV shows, and other content in Plex libraries
- `browse_libraries` — List all available Plex libraries (Movies, TV Shows, Music, etc.)
- `browse_library` — Browse content within a specific Plex library with filtering and sorting options
- `get_recently_added` — Get recently added content from Plex libraries
- `get_watch_history` — Get playback history for the Plex server
- `get_on_deck` — Get 'On Deck' items (continue watching) for users
- `list_playlists` — List all playlists on the Plex server
- `browse_playlist` — Browse and view the contents of a specific playlist with full track metadata
- `create_playlist` — Create a new regular playlist on the Plex server. Requires an initial item (item_key parameter) to be created successfu…
- `add_to_playlist` — Add items to an existing playlist
- `delete_playlist` — Delete an existing playlist
- `get_watched_status` — Check watch status and progress for specific content items
- `get_collections` — List all collections available on the Plex server
- `browse_collection` — Browse content within a specific collection
- `get_media_info` — Get detailed technical information about media files (codecs, bitrates, file sizes, etc.)
- `get_library_stats` — Get comprehensive statistics about Plex libraries (storage usage, file counts, content breakdown, etc.)
- `get_listening_stats` — Get detailed listening statistics and music recommendations based on play history and patterns
- `discover_music` — Natural language music discovery with smart recommendations based on your preferences and library
- `authenticate_plex` — Initiate Plex OAuth authentication flow to get user login URL
- `check_auth_status` — Check if Plex authentication is complete and retrieve the auth token
- `clear_auth` — Clear stored authentication credentials
- `validate_llm_response` — Validate LLM response format and content against expected schemas for different prompt types

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get vyb1ng/plex-mcp <tool-name>
```

## Resources

- `plex://status` — Current Plex server connection status

## Prompts (5)

- `playlist_description` (playlist_name, genre, content_info) — Generate a creative description for a playlist
- `content_recommendation` (liked_content, content_type, mood_or_genre) — Generate content recommendations based on viewing history or preferences
- `smart_playlist_rules` (intent, library_type) — Generate smart playlist criteria and rules
- `media_analysis` (content_data, analysis_type) — Analyze and categorize media content
- `server_troubleshooting` (error_details, server_info) — Help diagnose Plex server connection or performance issues

---

Source: https://github.com/vyb1ng/plex-mcp | License: NOASSERTION