MyShows

MCP for myshows.me

python

8

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "zeloras-myshows_mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/zeloras/myshows_mcp.git",
        "myshows_mcp"
      ],
      "env": {
        "MYSHOWS_LOGIN": "login",
        "MYSHOWS_PASSWORD": "pwd"
      }
    }
  }
}

You can run a local MCP server that connects to your myshows.me profile to search, track, and manage TV shows. This server exposes a set of tools you can call from an MCP client to interact with your MyShows data in a consistent, programmatic way.

How to use

To use the MyShows MCP Server, start the server locally and connect an MCP client to it. The server reads your credentials from environment variables, so you will first set your MyShows login information. Once the server is running, you can perform common tasks such as searching for shows, listing watched items, checking or unchecking episodes, and retrieving recommendations or your profile shows list. Use your MCP client to invoke the available tools by name and pass the required parameters to filter results or select items.

How to install

Prerequisites: you need a runtime that can execute the MCP runner used by the configuration. In this setup, you will run the MCP server using the provided command and pass the appropriate environment variables.

Set your MyShows credentials in the environment. Replace the placeholders with your actual login and password.
Start the MCP server with the exact command and arguments shown in the configuration snippet.

Additional notes

Environment variables are required for authentication. Keep your credentials secure and do not share them publicly.

If you need to stop the server, terminate the running process in your terminal. You can restart it at any time to refresh data from MyShows.

Available tools

search_shows

Search for TV shows by name with an optional year filter and pagination support.

watched_movies

Retrieve a list of movies you have watched.

get_movie_show_by_id

Fetch detailed information about a movie or show by its MyShows ID.

get_viewed_episodes

List episodes you have viewed for a specific show by its MyShows ID.

check_episode

Mark one or more episodes as watched using their MyShows IDs (supports single or batch operations).

uncheck_episode

Mark one or more episodes as unwatched using their MyShows IDs (supports single or batch operations).

set_movie_watch_status

Set the watch status of a movie by its MyShows ID.

get_calendar_episodes

Retrieve episodes scheduled for today.

get_myshows_recomendations

Fetch a list of recommendations from MyShows.

get_myshows_profile_shows_list

Retrieve shows from your MyShows profile.