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.

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    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.
    68
    4
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    An MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.
    8
  • 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
    -
    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.
    8
    3
    MIT

View all related MCP servers

Related MCP Connectors

  • Trakt MCP — TV/movie metadata + watch tracking signals

  • An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

  • Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/YoanWai/stremio-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server