stremio-mcp
Allows discovering Chromecast devices on the network and casting HTTP or torrent streams to them, with playback status, seek, and volume controls.
Allows discovering DLNA renderers on the network and playing HTTP or torrent streams to them, with playback status, seek, and volume controls.
Provides tools for searching movies and series, managing the Stremio library, installing and configuring addons across all devices, and controlling playback on desktop and Android TV.
Allows linking a Trakt account to Stremio and syncing watch history and library data through Stremio's first-party Trakt addon.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@stremio-mcp search for Inception"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpRelated 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 |
| (none) | account, addon, library tools | Stremio auth key, or call |
| (none) | TV tools | IP or hostname of the Android TV |
|
| adb TCP port on the TV | |
|
| Path to the adb binary | |
|
| subtitle addon | Port the built-in subtitle addon serves on |
| 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.keyTools
Find something to watch
Tool | Description |
| Search movies and series by name |
| Full metadata for a title, with the episode list for a series |
| Browse the top catalog, optionally by genre |
| Inspect one addon's manifest and capabilities |
| Ask one specific addon for streams |
| Ask every installed addon at once and merge the results |
| Search every installed addon catalog that supports search |
| Upcoming episodes for series in the account library |
| First unwatched regular episode from synced watch history |
| Hash-match OpenSubtitles and serve the selected subtitle |
Account and library
Tool | Description |
| Sign in with email and password, optionally remembering the key |
| Forget the stored key |
| Who is signed in |
| List library titles, filterable by type and watched state |
| Part-watched titles with resume positions |
| Add a title |
| Remove a title, keeping its watch state |
| Mark a title watched or unwatched everywhere |
| 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 |
| List installed addons in the order they are queried |
| Search the official addon directory |
| Install or upgrade an addon by manifest URL, at a chosen position |
| Open an addon's browser configuration and install its configured manifest |
| Remove an addon by id or URL |
| Change which addon answers first for streams |
| Reinstall Stremio's seven defaults |
| Reachability and latency for every installed addon |
| Compare live versions and optionally apply upgrades |
| Save the current ordered addon collection under a name |
| List named addon profiles and their addon ids |
| 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 |
| Whether the app is installed and its streaming server is up |
| Start the app and wait for its streaming server |
| Open a title, or the addons / library / settings page |
| Select an installed-addon stream and start playback, including resume |
| Open an addon's install page for a configurable addon |
| Download the matching installer for this OS and CPU |
| Discover Chromecast and DLNA renderers |
| Play an HTTP or torrent stream on a cast device |
| Status, playback, seek and volume controls for casting |
| Active torrent transfers and per-file progress |
| Cache limit, usage and torrent entries |
| 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 |
| Serve an .srt for a title, or for one episode |
| List what is being served |
| Stop serving one subtitle or all of a title's |
| Install the subtitle addon onto the account |
Android TV
Tool | Description |
| Pair Android 11+ wireless adb with a six-digit code |
| Open and start a title in the TV's Stremio app |
| Playback, navigation, volume and power |
| What is playing, with position and duration |
| Model, Android version, Stremio version, power, volume |
| Type into the focused field, such as the search box |
| Save a PNG of the TV screen |
| Push an .srt to the TV's Downloads folder for an external player |
adb pairing for the TV tools
On the TV: Settings > Device Preferences > About, then tap Build seven times.
In Developer options, turn on USB debugging and Network debugging.
Run
stremio_tv_pairwith the pairing port and six-digit code shown by Wireless debugging. Pass its separate connection port asconnect_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 testsLicense
MIT, see LICENSE.
Available Tools
55 toolsadd_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_searchB
Search movies or series by name through the public Cinemeta catalog.
Inputs: query (required), limit, content_type. 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
Scored across 55 tools
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.
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.
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.
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
Related MCP Connectors
Unlock a world of television with the TV Maze MCP server. Effortlessly search for shows by name or
The official MCP Server for the Mux API
Trakt MCP — TV/movie metadata + watch tracking signals
Remote MCP server for Web3TV creators — manage your account over MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn 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.5MIT
- FlicenseAqualityDmaintenanceAn 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-
- AlicenseAqualityDmaintenanceAn 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.620 npm5MIT
- FlicenseAqualityCmaintenanceMCP server for controlling Android, Fire TV, and Android TV devices through ADB, enabling device management, app operations, screenshots, UI dumps, and OBS recording.301-