Skip to main content
Glama

stremio-mcp

An MCP server for Stremio. It searches for something to watch, manages the account library, installs and orders addons across every device you are signed in on, and drives Stremio on a laptop or an Android TV.

Addons are installed through the Stremio account rather than through any one app's config files. The account is the shared source of truth, so a single stremio_install_addon call reaches Stremio desktop on macOS, Windows and Linux, the Android TV app, mobile and the web client at once.

Install

uvx stremio-mcp          # run without installing
pip install stremio-mcp  # or install it
brew install yoanwai/tap/stremio-mcp

Related MCP server: moviefinder-mcp

MCP client configuration

{
  "mcpServers": {
    "stremio": {
      "command": "uvx",
      "args": ["stremio-mcp"],
      "env": {
        "STREMIO_AUTH_KEY": "",
        "ANDROID_TV_HOST": "192.168.1.100"
      }
    }
  }
}

Point at a .env file instead with "args": ["--env-file", "/path/to/.env", "stremio-mcp"].

Environment

Variable

Default

Needed for

Purpose

STREMIO_AUTH_KEY

(none)

account, addon, library tools

Stremio auth key, or call stremio_login once

ANDROID_TV_HOST

(none)

TV tools

IP or hostname of the Android TV

ANDROID_TV_PORT

5555

adb TCP port on the TV

ADB_PATH

adb

Path to the adb binary

STREMIO_MCP_ADDON_PORT

9876

subtitle addon

Port the built-in subtitle addon serves on

STREMIO_MCP_STATE_DIR

platform data dir

Cached login, subtitle files, addon backups

Copy .env.example to .env and fill in what you need. Get an auth key from the console at web.stremio.com:

JSON.parse(localStorage.getItem("profile")).auth.key

Tools

Find something to watch

Tool

Description

stremio_search

Search movies and series by name

stremio_get_meta

Full metadata for a title, with the episode list for a series

stremio_browse_catalog

Browse the top catalog, optionally by genre

stremio_get_addon_manifest

Inspect one addon's manifest and capabilities

stremio_get_streams

Ask one specific addon for streams

stremio_find_streams

Ask every installed addon at once and merge the results

stremio_search_all_catalogs

Search every installed addon catalog that supports search

stremio_upcoming_episodes

Upcoming episodes for series in the account library

stremio_next_unwatched_episode

First unwatched regular episode from synced watch history

stremio_auto_fetch_subtitle

Hash-match OpenSubtitles and serve the selected subtitle

Account and library

Tool

Description

stremio_login

Sign in with email and password, optionally remembering the key

stremio_logout

Forget the stored key

stremio_account_status

Who is signed in

stremio_get_library

List library titles, filterable by type and watched state

stremio_continue_watching

Part-watched titles with resume positions

stremio_add_to_library

Add a title

stremio_remove_from_library

Remove a title, keeping its watch state

stremio_mark_watched

Mark a title watched or unwatched everywhere

stremio_trakt_sync

Link Trakt and sync Stremio's first-party Trakt addon

Addons

Changes here reach every signed-in device, which is how a laptop gets its addons.

Tool

Description

stremio_list_addons

List installed addons in the order they are queried

stremio_search_addons

Search the official addon directory

stremio_install_addon

Install or upgrade an addon by manifest URL, at a chosen position

stremio_configure_addon

Open an addon's browser configuration and install its configured manifest

stremio_uninstall_addon

Remove an addon by id or URL

stremio_reorder_addons

Change which addon answers first for streams

stremio_restore_default_addons

Reinstall Stremio's seven defaults

stremio_addon_health_check

Reachability and latency for every installed addon

stremio_check_addon_upgrades

Compare live versions and optionally apply upgrades

stremio_save_addon_profile

Save the current ordered addon collection under a name

stremio_list_addon_profiles

List named addon profiles and their addon ids

stremio_apply_addon_profile

Replace the account collection with a named profile

Every write merges against the live collection, keeps Stremio's protected addons, and snapshots the previous list under the state directory.

Desktop, on macOS / Windows / Linux

Tool

Description

stremio_desktop_status

Whether the app is installed and its streaming server is up

stremio_desktop_launch

Start the app and wait for its streaming server

stremio_desktop_open

Open a title, or the addons / library / settings page

stremio_desktop_play

Select an installed-addon stream and start playback, including resume

stremio_desktop_show_addon

Open an addon's install page for a configurable addon

stremio_desktop_download

Download the matching installer for this OS and CPU

stremio_cast_devices

Discover Chromecast and DLNA renderers

stremio_cast_play

Play an HTTP or torrent stream on a cast device

stremio_cast_control

Status, playback, seek and volume controls for casting

stremio_streaming_server_streams

Active torrent transfers and per-file progress

stremio_streaming_server_cache

Cache limit, usage and torrent entries

stremio_streaming_server_purge_cache

Stop engines and purge one torrent or the full cache

Subtitles

add_subtitle serves a subtitle file from this machine through a small addon, so it shows up in Stremio's own subtitle picker on any device on the LAN.

Tool

Description

add_subtitle

Serve an .srt for a title, or for one episode

list_subtitles

List what is being served

remove_subtitle

Stop serving one subtitle or all of a title's

sync_addon

Install the subtitle addon onto the account

Android TV

Tool

Description

stremio_tv_pair

Pair Android 11+ wireless adb with a six-digit code

play

Open and start a title in the TV's Stremio app

tv_control

Playback, navigation, volume and power

playback_status

What is playing, with position and duration

tv_status

Model, Android version, Stremio version, power, volume

tv_type_text

Type into the focused field, such as the search box

tv_screenshot

Save a PNG of the TV screen

push_subtitle

Push an .srt to the TV's Downloads folder for an external player

adb pairing for the TV tools

  1. On the TV: Settings > Device Preferences > About, then tap Build seven times.

  2. In Developer options, turn on USB debugging and Network debugging.

  3. Run stremio_tv_pair with the pairing port and six-digit code shown by Wireless debugging. Pass its separate connection port as connect_port.

The tool uses adb pair <host>:<port> <code>, then connects when a connection port is provided.

Development

uv venv && uv pip install -e ".[dev]"
pytest
ruff check src tests

License

MIT, see LICENSE.

Available Tools

55 tools
add_subtitleB

Serve a subtitle file for a title through the MCP subtitle addon.

subtitle_url is an http(s) link to an .srt file. Give season and episode to attach it to one episode; without them it covers the whole title. The subtitle then shows up in Stremio's subtitle picker on any device that can reach this machine on the LAN.

Inputs: imdb_id (required), subtitle_url (required), label, season, +2 more. Returns: result

list_subtitlesA

List every subtitle currently served by the MCP subtitle addon.

Inputs: no named parameters. Returns: result

playB

Open a movie or series episode in Stremio on the Android TV.

imdb_id like 'tt1375666'. For series pass season and episode. After the detail page opens, presses OK to start the highlighted stream.

Inputs: imdb_id (required), season, episode, content_type. Returns: result

playback_statusA

Report what Stremio is playing on the TV: title, state, position, duration (ms).

Inputs: no named parameters. Returns: result

push_subtitleA

Push an SRT subtitle file to the Android TV Downloads folder.

subtitle_url_or_path: URL to download the SRT from, or a local absolute path. filename: name for the file on the TV (must end in .srt). Set clear_player_default to also forget Stremio's chosen video app, so Android asks again on the next play and an external player like VLC can take over. For subtitles inside Stremio itself, use add_subtitle.

Inputs: subtitle_url_or_path (required), filename, clear_player_default. Returns: result

remove_subtitleB

Stop serving subtitles for a title. Omit subtitle_id to remove them all.

Inputs: imdb_id (required), season, episode, subtitle_id. Returns: result

stremio_account_statusA

Report whether a Stremio account is reachable and who is signed in.

Inputs: no named parameters. Returns: result

stremio_addon_health_checkA

Check every installed addon's manifest reachability and latency.

Inputs: no named parameters. Returns: result

stremio_add_to_libraryA

Add a movie or series to the account library by IMDb id.

Re-adding a title that was removed restores it with its watch state.

Inputs: imdb_id (required), content_type. Returns: result

stremio_apply_addon_profileA

Replace the account addon collection with a saved named profile.

The protected-addon guard and automatic backup are applied before the account write.

Inputs: name (required). Returns: result

stremio_auto_fetch_subtitleB

Fetch a hash-matched OpenSubtitles result and serve it through add_subtitle.

Pass a playable video_url while Stremio desktop is running so its server calculates the hash, or provide video_hash and video_size directly.

Inputs: imdb_id (required), season, episode, filename, +5 more. Returns: result

stremio_browse_catalogC

Browse the public Cinemeta top catalog, optionally filtered by genre.

Inputs: skip, genre, content_type. Returns: result

stremio_cast_controlC

Read or control cast playback with status, pause, resume, stop, seek or volume.

Inputs: action (required), device (required), value. Returns: result

stremio_cast_devicesA

Discover Chromecast and DLNA renderers through Stremio desktop.

Inputs: no named parameters. Returns: result

stremio_cast_playB

Play an HTTP stream or local torrent engine file on Chromecast or DLNA.

device accepts a discovered id or exact name. Pass stream_url, or pass info_hash and file_index for a torrent active in Stremio desktop.

Inputs: device (required), info_hash, file_index, stream_url, +1 more. Returns: result

stremio_check_addon_upgradesA

Compare installed addon versions with live manifests and optionally apply upgrades.

Leave apply false to inspect. Set apply true to reinstall every newer manifest in one guarded account collection update.

Inputs: apply. Returns: result

stremio_configure_addonA

Run a configurable addon's browser setup and install its result.

First call with a directory addon id, name or transport URL. The tool reports the page fields and opens the configuration page. Complete that page, then call again with the configured manifest URL it produces.

Inputs: addon (required), position, configured_manifest_url, open_configuration_page. Returns: result

stremio_continue_watchingA

List part-watched titles with their resume positions, most recent first.

This is the row Stremio shows on its home board. position_ms is where playback stopped, so it can be handed straight to a player.

Inputs: limit. Returns: result

stremio_desktop_downloadA

Download the Stremio desktop installer for this machine's OS and CPU.

Reads the official downloads page, picks the macOS .dmg, the Windows .exe or the Linux .deb that matches the architecture, and saves it to the Downloads folder. Pass target_platform as 'Darwin', 'Windows' or 'Linux' to fetch an installer for a different machine. Running the installer is left to you because it needs an admin password.

Inputs: destination, target_platform. Returns: result

stremio_desktop_launchA

Launch Stremio desktop on this machine and wait for its streaming server.

Run this before asking the desktop app to play something, and after installing addons so the app pulls the new collection from the account.

Inputs: wait_seconds. Returns: result

stremio_desktop_openA

Open a title, or a named page, in Stremio desktop on this machine.

Pass an imdb_id like 'tt1375666' to open its detail page, adding season and episode for a series. Or pass page as one of 'addons', 'library', 'board', 'search', 'settings' to jump straight there.

Inputs: page, season, episode, imdb_id, +1 more. Returns: result

stremio_desktop_playB

Select an installed-addon stream and start it in Stremio desktop.

Streams follow installed addon order, then each addon's result order. stream_index selects from that merged list. For a continue-watching item, pass its video_id so Stremio restores the account's saved timeOffset.

Inputs: imdb_id (required), season, episode, video_id, +3 more. Returns: result

stremio_desktop_show_addonA

Open an addon's install page in Stremio desktop so it can be reviewed.

Use this for addons that need configuring by hand. For a headless install that also reaches every other device, use stremio_install_addon instead.

Inputs: manifest_url (required), content_type. Returns: result

stremio_desktop_statusA

Report whether Stremio desktop is installed and running on this machine.

Works on macOS, Windows and Linux. The streaming server is the local component that turns torrents into playable HTTP streams; it only answers while the desktop app is open.

Inputs: no named parameters. Returns: result

stremio_find_streamsB

Ask every stream addon on the account for a title, all at once.

This is what Stremio itself does when you open a title: it queries the installed addons in order and merges the results. Addons that fail or have nothing are reported separately rather than silently dropped.

Inputs: imdb_id (required), season, episode, per_addon, +1 more. Returns: result

stremio_get_addon_manifestC

Fetch a Stremio addon's manifest and summarize what it can do.

Inputs: addon_url (required). Returns: result

stremio_get_libraryA

List the account's library titles.

include_removed also lists soft-deleted entries, which is where watch history lives. content_type filters to 'movie' or 'series'. watched is 'any', 'yes' or 'no'.

Inputs: watched, content_type, include_removed. Returns: result

stremio_get_metaB

Get full metadata for a title by IMDb id, including the episode list for a series.

Inputs: imdb_id (required), content_type. Returns: result

stremio_get_streamsB

Ask one specific addon for the streams it has for a movie or episode.

Inputs: imdb_id (required), addon_url (required), season, episode, +1 more. Returns: result

stremio_install_addonA

Install an addon onto the Stremio account by its manifest URL.

It shows up on every signed-in device: Stremio desktop on macOS, Windows and Linux, Android TV, mobile and web. Reinstalling an already-present addon upgrades it in place. position places the addon in the query order (0 is queried first); -1 appends.

Inputs: manifest_url (required), position. Returns: result

stremio_list_addon_profilesA

List saved addon profiles and the ordered addon ids in each one.

Inputs: no named parameters. Returns: result

stremio_list_addonsA

List the addons installed on the Stremio account.

These are the addons every signed-in device sees, including Stremio desktop on macOS, Windows and Linux. Order matters: for a given stream request Stremio queries addons top to bottom.

Inputs: no named parameters. Returns: result

stremio_loginA

Sign in to a Stremio account with an email and password.

The auth key is kept for this server's lifetime and, with remember, also cached in the user state directory so later runs stay signed in. Accounts created through Facebook or Google cannot use this; set STREMIO_AUTH_KEY for those.

Inputs: email (required), password (required), remember. Returns: result

stremio_logoutA

Forget the stored Stremio auth key on this machine.

Inputs: no named parameters. Returns: result

stremio_mark_watchedA

Mark a library title watched or unwatched across every signed-in device.

Marking it watched also clears the resume position so it leaves the continue-watching row.

Inputs: imdb_id (required), watched, content_type. Returns: result

stremio_next_unwatched_episodeC

Resolve the first unwatched regular episode using synced library history.

Inputs: imdb_id (required), include_unreleased. Returns: result

stremio_remove_from_libraryB

Remove a title from the account library. Watch state is kept.

Inputs: imdb_id (required). Returns: result

stremio_reorder_addonsA

Set the order Stremio queries addons in, highest priority first.

Pass the addon ids you care about; anything you leave out keeps its relative order behind them. Stream results follow this order, so moving a preferred stream provider to the front changes what plays first.

Inputs: addon_ids (required). Returns: result

stremio_restore_default_addonsA

Reinstall Stremio's seven default addons onto the account.

Use this when the addon list is empty or broken. keep_installed keeps any other addon already on the account and only fills in the missing defaults; pass false to reset the account to a stock addon list.

Inputs: keep_installed. Returns: result

stremio_save_addon_profileC

Save the account's current ordered addon collection under a name.

Inputs: name (required), overwrite. Returns: result

stremio_search_addonsA

Search the official Stremio addon directory for addons to install.

Leave query empty to list the directory. Pass a returned transportUrl to stremio_install_addon. Addons flagged configuration_required must be configured in a browser first, which produces the real manifest URL.

Inputs: limit, query. Returns: result

stremio_search_all_catalogsC

Search every installed addon catalog that declares search support.

Inputs: query (required), per_catalog, content_type. Returns: result

stremio_streaming_server_cacheA

Show the desktop streaming server's cache limit, usage and torrent entries.

Inputs: no named parameters. Returns: result

stremio_streaming_server_purge_cacheA

Delete cached torrent data after stopping the matching torrent engines.

Set confirm=true. Pass one info_hash to purge that torrent, or leave it empty to purge the complete desktop torrent cache.

Inputs: confirm, info_hash. Returns: result

stremio_streaming_server_streamsA

List active torrent engines, transfer rates and per-file download progress.

The Stremio desktop app must be running. Pass an info_hash to inspect one engine, or leave it empty to inspect every active torrent.

Inputs: info_hash. Returns: result

stremio_trakt_syncA

Link Trakt in the browser, then install or refresh Stremio's Trakt addon.

On the first call, the account-specific authorization page opens. After authorizing Trakt, run the tool again to sync the first-party addon.

Inputs: open_auth. Returns: result

stremio_tv_pairA

Pair adb with an Android 11+ TV using its six-digit wireless code.

pairing_port is the port shown beside the pairing code. host defaults to ANDROID_TV_HOST. Pass connect_port when the TV shows a separate wireless debugging port and the tool will connect after pairing.

Inputs: pairing_code (required), pairing_port (required), host, connect_port. Returns: result

stremio_uninstall_addonB

Remove an addon from the account by its manifest URL or its addon id.

Inputs: addon (required). Returns: result

stremio_upcoming_episodesB

List episodes releasing soon for series in the account library.

Inputs: days, limit. Returns: result

sync_addonA

Install the MCP subtitle addon onto the Stremio account.

Run this if the addon is missing from the subtitle picker. Every other installed addon is left untouched.

Inputs: no named parameters. Returns: result

tv_controlA

Control the TV: category is 'volume' | 'playback' | 'navigate' | 'power'.

volume: up/down/mute/status, or set with value in the device's own range. playback: play/pause/toggle/stop/next/previous/forward/rewind. navigate: up/down/left/right/select/back/home. power: wake/sleep/toggle/status.

Inputs: action (required), category (required), value. Returns: result

tv_screenshotA

Capture what the TV is showing and save it as a PNG on this machine.

Use it to see which item the remote is sitting on before pressing select.

Inputs: save_path. Returns: result

tv_statusA

Report the TV: model, Android version, installed Stremio version, power and volume.

Run this first when a TV tool misbehaves; it proves whether adb can reach the device at all.

Inputs: no named parameters. Returns: result

tv_type_textA

Type text into whatever field is focused on the TV, such as Stremio's search box.

Inputs: text (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 55 tools

    Disambiguation3/5

    Most tools target distinct resources or platforms, and the descriptions clarify device-specific playback, addon installation, and subtitle handling. However, there is meaningful overlap among the many playback, search, and addon-management tools (e.g., play vs. stremio_desktop_play vs. stremio_cast_play; search vs. search_all_catalogs; install/configure/show addon), so an agent must read carefully to avoid misselection.

    Naming Consistency3/5

    Most tools use snake_case with a stremio_ prefix, but a significant subset (play, add_subtitle, tv_control, push_subtitle, sync_addon, playback_status, etc.) omits that prefix and mixes verb-first, noun-first, and bare-verb styles. The result is readable but not a consistent verb_noun convention.

    Tool Count2/5

    55 tools is far beyond the practical range for an MCP server, even one covering account, desktop, TV, casting, subtitles, and addons. Many operations could be consolidated or grouped, and the large surface will burden tool selection and agent context.

    Completeness4/5

    The surface is extensive: authentication, discovery, library/watch state, addon lifecycle and profiles, subtitle serving/pushing, desktop, streaming server, Android TV, casting, and Trakt sync are all represented. Minor gaps exist (e.g., deleting saved addon profiles, browsing arbitrary installed catalogs), but core workflows are well covered.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables users to search for movie and TV show resources across multiple sources and validate video link playability. It supports both STDIO and SSE transport modes for seamless integration with AI applications.
      5
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      An MCP server that wraps the TMDB API, enabling search of movies and TV shows, retrieval of details, trending titles, recommendations, and streaming provider information.
      8
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that lets AI agents control Android TVs via ADB, including searching and playing content across streaming services, managing power and volume, and sending remote control commands.
      6
      20 npm
      5
      MIT