TVWizard
Control Android TV from any AI. 21 MCP tools: keys, apps, titles, playback, volume, observe.
Ask AI about TVWizard
Powered by Claude Β· Grounded in docs
I know everything about TVWizard. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
TVWizard
Your TV, controlled by any AI β from anywhere.
Cloud relay + MCP server for Android TV and Google TV.
Website Β· Pricing Β· Download bridge Β· Quickstart Β· Tool reference
What it is
TVWizard turns any Claude-compatible AI chat into a universal remote. Pair your Android TV or Google TV once with a 6-digit code, and from that moment on you can say "put on Scrubs S2E5" or "turn the bedroom TV off" from your phone, your laptop, your car β anywhere you talk to Claude.
It works through the Model Context Protocol, the emerging standard for AI agents controlling real-world tools.
How it works
βββββββββββββ βββββββββββββββββββ βββββββββββββββββββββββ
β Claude βββMCPββΆβ TVWizard Relay βββWSβββΆβ TVWizard Bridge β
β (any) β β tv.djwizard.ai β β (Android TV app) β
βββββββββββββ βββββββββββββββββββ βββββββββββββββββββββββ
β² β
ββββββββββ pairing code (6 digits) βββββββββββββββββ
The bridge connects outbound to the relay β no port forwarding, no VPN, no same-Wi-Fi requirement. Your TV at home obeys commands from your phone abroad.
Install (5 minutes)
- Get the bridge APK from the latest release. Install on your Android TV or Google TV. (Sideload instructions in docs/install-bridge.md.)
- Open the app, tap Pair. The TV shows a 6-digit code.
- Go to tv.djwizard.ai/claim.html, type the code, pick a device name (e.g.
living-room). Copy the bearer token + the Claude Desktop config snippet it generates. - Paste into Claude Desktop (see docs/claude-desktop.md). Restart the app.
- Talk to your TV. Try: "What's on my living-room TV right now?" or "Put on Stranger Things season 1 episode 1."
MCP tools
| Tool | What |
|---|---|
tv.list_devices | Lists TVs paired to your account. |
tv.send_key | Sends a key: POWER, HOME, UP/DOWN/LEFT/RIGHT, OK, BACK, VOL_UP/DOWN. |
tv.launch_app | Opens an Android Intent β YouTube deep links, Netflix titles, any HTTPS URL. |
tv.list_apps | Enumerates installed apps so your AI knows what's available. |
tv.play_title | Resolves "Scrubs S2E5" to a country-specific provider deep link (Netflix, Disney+, Max, Apple TV+, and more) via TMDB + JustWatch. |
tv.observe | Reads back the TV screen state: foreground app, focused element, visible clickable nodes. |
Full reference with examples: docs/mcp-tools.md.
Supported providers
tv.play_title resolves titles via TMDB β JustWatch β a region-aware Android package map, with a 60-day cache. Streaming catalogs vary by country; Stremio (virtual, IMDB-keyed) fills gaps where JustWatch coverage is patchy.
| Category | Providers |
|---|---|
| Subscription | Netflix, Disney+ (MEA-aware), Prime Video, Max, Hulu, Apple TV+, Paramount+, Peacock, fuboTV |
| Free / ad-supported | YouTube |
| Virtual (IMDB-keyed) | Stremio |
Pricing
Early access is free. Pricing tiers are finalized at tv.djwizard.ai/pricing.html.
Privacy + trust
- Open-source bridge. Audit exactly what runs on your TV.
- Hosted in Frankfurt (EU), GDPR-compliant. Privacy policy.
- Your command content is not logged, not sold, not used to train anything.
- Fails loudly β if the TV is offline, your AI gets an immediate error, not a queued ghost command.
Status
- Relay: live at
tv.djwizard.ai. Uptime: stats.uptimerobot.com. - v0.3.0 (April 2026): six MCP tools, full title resolution chain, public claim UX. See CHANGELOG.md.
- v0.4 (next): Samsung Tizen bridge, user accounts for multi-household, Claude.ai-native connector registration.
Support
- Bug / issue: open an issue
- General:
hi@tv.djwizard.ai - Security:
security@djwizard.ai(see SECURITY.md) - Business / hotels:
hotels@djwizard.ai
License
Documentation in this repo is under MIT. The bridge APK is Apache 2.0 (source: coming soon). The relay is source-available, non-commercial.
