Plex MCP server Let your AI agent keep your Plex in order.

ToolWhat it doesAccess

• list_libraries The libraries of your Plex server with their type and item count. read

  Returns every library you can see on the server you are signed in to, such as Movies, TV Shows or Music. Use library as the library parameter of the other tools. The count is the number of top-level items Plex Web shows for that library. It reads only; nothing changes in Plex.

  MCP callplex_read → list_libraries

  REST endpointGET https://cotlet.dev/api/v1/plex/libraries

  Parameters

  No parameters.

  Example response

  {
    "libraries": [
      {
        "library": "Movies",
        "type": "Movies",
        "items": 412
      },
      {
        "library": "TV Shows",
        "type": "TV Shows",
        "items": 87
      },
      {
        "library": "Music",
        "type": "Music",
        "items": 1560
      }
    ]
  }

• list_library_items Items of one library with title, year, watched state and date added. read

  Lists the items of one library as Plex Web shows them, one page at a time. Pass next_cursor back as cursor for the next page. unwatched true keeps only titles you have not finished. item_id is the key for get_media_item, mark_watched and add_to_playlist. It reads only.

  MCP callplex_read → list_library_items

  REST endpointGET https://cotlet.dev/api/v1/plex/library-items

  Parameters

  Parameters: list_library_items

  Name	Type	Description
  library string required	string	Library name as list_libraries returns it, e.g. 'Movies'.
  unwatched boolean	boolean	True keeps only items you have not watched.
  limit integer	integer	Items per page.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "library": "Movies"
  }

  Example response

  {
    "items": [
      {
        "item_id": "48213",
        "title": "The Quiet Harbor",
        "year": 2024,
        "watched": false,
        "added": "2026-10-28"
      },
      {
        "item_id": "48190",
        "title": "Night Ferry",
        "year": 2023,
        "watched": true,
        "added": "2026-10-21"
      }
    ],
    "next_cursor": "2"
  }

• search_media Search your libraries by title and see which library each match is in. read

  Searches the libraries of your server for a title, the way the search box in Plex Web does. Each match carries its library, type and watched state. Leave library out to search all of them. A title that is only on your Watchlist and not in a library does not appear here; list_watchlist shows those.

  MCP callplex_read → search_media

  REST endpointGET https://cotlet.dev/api/v1/plex/medias/search

  Parameters

  Parameters: search_media

  Name	Type	Description
  query string required	string	Title or part of a title.
  library string	string	Search only this library.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "results": [
      {
        "item_id": "48213",
        "title": "The Quiet Harbor",
        "type": "Movie",
        "year": 2024,
        "library": "Movies",
        "watched": false
      }
    ]
  }

• get_media_item One movie, show, season or episode with summary, runtime and watched state. read

  Returns the details page of one item: summary, year, runtime, watched state and, for a show, its seasons and episodes with their own item_id. Use the episode ids with mark_watched. It reads only.

  MCP callplex_read → get_media_item

  REST endpointGET https://cotlet.dev/api/v1/plex/items/{item_id}/media-item

  Parameters

  Parameters: get_media_item

  Name	Type	Description
  item_id string required	string	Item id from search_media or list_library_items.

  Example input

  {
    "item_id": "item_8c41d2"
  }

  Example response

  {
    "item_id": "48290",
    "title": "Salt Road",
    "type": "Show",
    "year": 2022,
    "watched": false,
    "summary": "A courier crosses a desert coast road one delivery at a time.",
    "seasons": [
      {
        "item_id": "48291",
        "title": "Season 1",
        "episodes": 8,
        "watched_episodes": 8
      },
      {
        "item_id": "48299",
        "title": "Season 2",
        "episodes": 8,
        "watched_episodes": 5
      }
    ]
  }

ToolWhat it doesAccess

• list_watchlist Titles on your Plex Watchlist, with type, year and whether they are in your libraries. read

  Lists the movies and shows on the Watchlist of the signed-in account. Plex keeps movies and shows on it, not single seasons or episodes. in_library is true when a title also sits in a library of your server. It reads only.

  MCP callplex_read → list_watchlist

  REST endpointGET https://cotlet.dev/api/v1/plex/watchlists

  Parameters

  Parameters: list_watchlist

  Name	Type	Description
  type enum	enum	movie or show. Default: both.

  Example response

  {
    "watchlist": [
      {
        "title": "Paper Lanterns",
        "type": "Movie",
        "year": 2025,
        "in_library": false
      },
      {
        "title": "Low Tide",
        "type": "Show",
        "year": 2024,
        "in_library": true
      }
    ]
  }

• add_to_watchlist Put a movie or show on your Plex Watchlist. write

  Adds one movie or show to the Watchlist of the signed-in account. Plex accepts movies and shows, not single seasons or episodes. A title already on the list is left alone. It reaches no one and is undone with remove_from_watchlist, so it does not wait for your OK.

  MCP callplex_write → add_to_watchlist

  REST endpointPOST https://cotlet.dev/api/v1/plex/watchlists

  Parameters

  Parameters: add_to_watchlist

  Name	Type	Description
  title string required	string	Title to add, e.g. 'Paper Lanterns'.
  year integer	integer	Year of release, to pick the right title when two share a name.

  Example input

  {
    "title": "Paper Lanterns"
  }

  Example response

  {
    "title": "Paper Lanterns",
    "type": "Movie",
    "on_watchlist": true
  }

• remove_from_watchlist Take a title off your Plex Watchlist. write

  Removes one movie or show from the Watchlist of the signed-in account. If the title is not on it, nothing changes. It reaches no one and is undone with add_to_watchlist, so it does not wait for your OK.

  MCP callplex_write → remove_from_watchlist

  REST endpointDELETE https://cotlet.dev/api/v1/plex/watchlists

  Parameters

  Parameters: remove_from_watchlist

  Name	Type	Description
  title string required	string	Title to remove.
  year integer	integer	Year of release, to pick the right title when two share a name.

  Example input

  {
    "title": "title"
  }

  Example response

  {
    "title": "Low Tide",
    "type": "Show",
    "on_watchlist": false
  }

ToolWhat it doesAccess

• mark_watched Mark a movie, episode, season or show as watched or unwatched. write

  Does what Mark as Watched and Mark as Unwatched do in Plex Web. Give a season or show id to change all its episodes at once. watched false marks it unwatched again. It changes only your own watched state and is undone with the same call, so it does not wait for your OK. Plex can drop a watched title from your Watchlist.

  MCP callplex_write → mark_watched

  REST endpointPOST https://cotlet.dev/api/v1/plex/items/{item_id}/watched/mark

  Parameters

  Parameters: mark_watched

  Name	Type	Description
  item_id string required	string	Item id from search_media, list_library_items or get_media_item.
  watched boolean required	boolean	True marks watched, false marks unwatched.

  Example input

  {
    "item_id": "item_8c41d2",
    "watched": true
  }

  Example response

  {
    "item_id": "48299",
    "title": "Salt Road, Season 2",
    "watched": true,
    "episodes_changed": 3
  }

• list_playlists Your Plex playlists with item count and type. read

  Returns the playlists of the signed-in account with their name, the kind of media they hold and how many items they contain. A smart playlist is marked smart: true; Plex does not let you add items to those by hand, so add_to_playlist skips them. It reads only.

  MCP callplex_read → list_playlists

  REST endpointGET https://cotlet.dev/api/v1/plex/playlists

  Parameters

  No parameters.

  Example response

  {
    "playlists": [
      {
        "playlist": "Rainy Sunday",
        "type": "video",
        "items": 9,
        "smart": false
      },
      {
        "playlist": "Recently added",
        "type": "video",
        "items": 24,
        "smart": true
      }
    ]
  }

• add_to_playlist Add items to one of your playlists, or create it with the first items. write

  Adds the items to the end of the playlist you name and creates the playlist if it does not exist. Plex does not allow adding by hand to a smart playlist, so the call fails with the playlist name. Items of different media types end up in separate playlists of the same name. A playlist is yours and reaches no one, so this call does not wait for your OK.

  MCP callplex_write → add_to_playlist

  REST endpointPOST https://cotlet.dev/api/v1/plex/playlists

  Parameters

  Parameters: add_to_playlist

  Name	Type	Description
  playlist string required	string	Playlist name.
  item_ids array required	array	Item ids from search_media or list_library_items.

  Example input

  {
    "playlist": "playlist",
    "item_ids": "item ids"
  }

  Example response

  {
    "playlist": "Rainy Sunday",
    "added": 3,
    "total_items": 12,
    "created": false
  }

• list_collections Collections of a library with their items. read

  Returns the collections of one library, each with the titles it holds. Collections belong to the library and are visible to the people who share it. It reads only.

  MCP callplex_read → list_collections

  REST endpointGET https://cotlet.dev/api/v1/plex/collections

  Parameters

  Parameters: list_collections

  Name	Type	Description
  library string required	string	Library name as list_libraries returns it.

  Example input

  {
    "library": "library"
  }

  Example response

  {
    "collections": [
      {
        "collection": "Desert Road Movies",
        "items": 6
      },
      {
        "collection": "Slow Cinema",
        "items": 11
      }
    ]
  }

ToolWhat it doesAccess

• list_library_access Plex accounts with access to your server and the libraries each can see. read

  Reads the Manage Library Access page: every account you shared your server with, the libraries it can use and whether an invite is still waiting. Only the server owner can open that page; other accounts get APP_PERMISSION_DENIED. It reads only.

  MCP callplex_read → list_library_access

  REST endpointGET https://cotlet.dev/api/v1/plex/library-access

  Parameters

  No parameters.

  Example response

  {
    "accounts": [
      {
        "name": "sam",
        "status": "accepted",
        "libraries": [
          "Movies"
        ]
      },
      {
        "name": "lena@example.com",
        "status": "invited",
        "libraries": [
          "Movies",
          "TV Shows"
        ]
      }
    ]
  }

• grant_library_access Invite a Plex account to use chosen libraries of your server. writeasks first

  Runs the Grant Library Access wizard under Settings > Manage Library Access: you give the username or email, pick libraries and Plex sends the invite. Only the server owner can do this, and only for a server they own. Leave libraries out to share all of them. By default you confirm each call; you can switch that off for this tool.

  MCP callplex_write → grant_library_access

  REST endpointPOST https://cotlet.dev/api/v1/plex/library-access/grant

  Parameters

  Parameters: grant_library_access

  Name	Type	Description
  account string required	string	Plex username or email of the person to invite.
  libraries array	array	Library names to share. Default: all libraries.

  Example input

  {
    "account": "sam@example.com",
    "libraries": [
      "Movies"
    ]
  }

  Example response

  {
    "account": "sam@example.com",
    "status": "invited",
    "libraries": [
      "Movies"
    ]
  }

• revoke_library_access Remove a Plex account's access to your server. writeasks first

  Does what the X next to a name does on Manage Library Access: the account loses access to your libraries. Only the server owner can do this. The person can be invited again with grant_library_access. By default you confirm each call; you can switch that off for this tool.

  MCP callplex_write → revoke_library_access

  REST endpointPOST https://cotlet.dev/api/v1/plex/library-access/revoke

  Parameters

  Parameters: revoke_library_access

  Name	Type	Description
  account string required	string	Username or email as list_library_access returns it.

  Example input

  {
    "account": "account"
  }

  Example response

  {
    "account": "lena@example.com",
    "status": "removed"
  }