elisa-tv-mcp
Controls Android / Google TV devices over ADB network debugging, including power, volume, remote keys, app launching, text input, screen reading, screenshots, and playback through the Elisa app.
Integrates with Google TV devices to control the TV, launch apps, read the screen, and interact with the Elisa TV guide and playback experience.
Supports Sony BRAVIA Android TVs, including Sony-specific remote-key handling and channel-tuning behavior, plus TV control for power, volume, apps, screenshots, and on-screen state.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
elisa-tv-mcp
MCP server that lets an AI agent on your LAN use the Elisa Elamus TV guide and control an Android / Google TV (tested: Sony BRAVIA 4K VH21, Android 12).
Guide: the Elisa guide (14 days back, 7 ahead) for the channels in your subscription is kept in a local SQLite/FTS5 database, refreshed every 2 hours, and searched in milliseconds ("Pilvede all", "the episode before S08E12", "what's on ETV tonight").
Play from the guide:
elisa_play(listing_id)opens any catch-up or currently airing programme directly in the Elisa app and starts it (~10–20 s, also from the TV home screen or a cold app start).TV: power, volume, remote keys, app launch, reading the screen as text, screenshots (non-DRM) — over ADB network debugging.
Transport: streamable HTTP on the LAN (
http://<host>:8765/mcp), protected by an API key.
Install
Requirements: Linux with systemd (user services), Python 3.10+ with venv, the TV and this machine
on the same LAN, and network debugging enabled on the TV
(Settings → System → About → click Build 7× → Developer options → USB debugging + Network debugging).
git clone https://github.com/thucar/elisa-MCP.git && cd elisa-MCP
./install.shThe wizard:
finds
adbor downloads Google's platform-tools,scans the local network for TVs with ADB open (falls back to asking the IP) and connects — accept "Allow network debugging" on the TV (tick always allow),
links your paying Elisa Elamus account with a pairing code, exactly like the Elisa TV app: it shows a short code and a QR code; scan it with your phone (or open elisaelamus.ee/lisa), log in and confirm. The channel list then follows your subscription automatically. Skipping this uses guest mode plus a package you pick,
generates the API key, downloads the guide, installs and starts the
elisa-tvsystemd user service,prints how to connect an agent, e.g.
claude mcp add --transport http elisa-tv http://192.168.1.10:8765/mcp --header "Authorization: Bearer <key>"
Non-interactive: ./install.sh --non-interactive --tv-host 192.168.1.50 --skip-elisa-login --package "Pisike Elamus".
Related MCP server: adb-tv-mcp
Commands
| TV, Elisa login, guide and service health |
| print the URL / API key / client snippets again |
| (re)link the Elisa account with a new pairing code |
| forget the account (guest mode) |
| download the guide now |
| re-run the wizard (keeps existing settings/key) |
| server logs |
| remove (purge also deletes config, tokens, guide) |
Files: config + API key ~/.config/elisa-tv/config.json; Elisa tokens, guide DB, adb
~/.local/share/elisa-tv/ (secrets are mode 0600).
Security notes
Anyone with the API key can control the TV. HTTP on the LAN is not encrypted — keep it on a trusted network (or put it behind a TLS reverse proxy / VPN). Rotate the key by deleting
http.api_keyfrom the config and re-runningelisa-tv setup.The TV trusts this computer's ADB key (
~/.android/adbkey); revoke under Developer options.The Elisa login is a long-lived device token (like the TV app's), stored locally only and used only against elisaelamus.ee. It may be listed among your Elisa devices; removing it there revokes access.
Only guide data for subscribed channels is requested from Elisa.
Tools
Guide: search_guide, series_episodes, channel_schedule, whats_on, list_channels,
program_details, guide_status, refresh_guide.
Playback: elisa_play (catch-up and live, via the guide's listing id), elisa_tune_channel
(live TV by channel number or name, ~6 s, confirmed from the on-screen banner).
TV: tv_status, tv_keys, tv_type_text, tv_power, tv_volume, tv_launch_app,
tv_installed_apps, tv_screen, tv_screenshot.
Known limits
The Elisa API is the private frontend API of elisaelamus.ee; it may change without notice.
Screenshots are refused by the TV while DRM video (e.g. Elisa) is on screen;
tv_screenthen shows nothing either unless a menu is open.elisa_playuses the Elisa app's own deep link to a programme's page and presses its play button: a new episode plays from the start ("Vaata"), a partly watched one continues ("Jätka"); there is no "from the beginning" button for partly watched items.Sony TVs send number keys injected by software (
input keyevent) to Sony's own tuner app. The server therefore types digits through a temporary virtual USB keyboard (Android'shidtool), which the TV treats like a real remote, sotv_keysdigits andelisa_tune_channelbehave like the remote.
License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.
Give your AI agent the power to cast to your home TV and control an interactive canvas. By ArdaBot.
Give your AI agent a real cloud Android phone: push APKs, drive it, get screenshots and logs.
Let AI agents control Android and iOS devices on Mobilerun Cloud: screen, input, apps, workflows.
Related MCP Servers
- 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
- AlicenseBqualityCmaintenanceEnables AI agents to control Android TV/Android devices through ADB, including screen capture, remote control, app management, and more.2415 npm4MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to drive an Android TV or Google TV box end to end through named tools — discover, pair, connect, check, install, provision, link, test, screenshot, report and a gated shell — with usage instructions embedded in the tool descriptions so the agent never improvises adb. Every command passes the same safety gate that refuses destructive actions.15Apache 2.0
- AlicenseNot gradedqualityCmaintenanceGives AI coding agents eyes and hands on a TV: capture the screen as an image, press remote keys, type text, read console logs and JS errors, deploy projects, launch apps, and apply or revert system tweaks across Android TV, Google TV, Fire TV, Roku and LG webOS. This lets an agent design, live-check and iterate on a custom ad-free home screen directly on the big screen.2MIT