> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickwheel.fm/llms.txt
> Use this file to discover all available pages before exploring further.

# Plex

> clickwheel MCP server tools for Plex.

**Try asking Claude**

* *"Is my Plex connection working?"*
* *"Push my road-trip playlist to Plexamp."*
* *"What playlists are on Plex?"*

## `list_plex_playlists`

List every audio playlist on the user's Plex server.

## `plex_health`

Probe the Plex integration end-to-end without changing anything.

## `pull_playlist_from_plex`

Recover a Plex audio playlist into clickwheel's local SQLite.

<ParamField path="name" type="string" required>
  Plex playlist name to recover into clickwheel.
</ParamField>

<ParamField path="include_smart" type="boolean">
  Required to pull a smart playlist. Materializes a snapshot rather than mirroring the live query.
</ParamField>

<ParamField path="overwrite" type="boolean">
  Replace an existing clickwheel playlist with the same name. Without this, the operation refuses to clobber.
</ParamField>

## `sync_playlist_to_plex`

Push a clickwheel playlist into the user's Plex music library so it shows up in Plex web and Plexamp alongside the iPod sync.

<ParamField path="playlist" type="string" required>
  Saved clickwheel playlist name to push to Plex.
</ParamField>