Apple TV MCP

Name: Apple TV MCP
Author: trevor-nichols

de trevor-nicholsversión 0.2.0i★ 1iSe ejecuta en tu computadora

Nombre en el registroio.github.trevor-nichols/appletv-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

Local MCP server for semantic Apple TV control with optional screenshots.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi2 de 2 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo↓ 41/sem · ★ 1

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 2 de 2 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
El registro no indica ninguna clave que completar.

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "appletv": {
      "command": "uvx",
      "args": [
        "appletv-mcp",
        "serve"
      ]
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add appletv -- uvx appletv-mcp serve

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "appletv": {
      "command": "uvx",
      "args": [
        "appletv-mcp",
        "serve"
      ]
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "appletv": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "appletv-mcp",
        "serve"
      ]
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 10 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub trevor-nichols, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 2 meses
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 82% de los otros 19092 servidores de esta categoría
Publicado en el registro más recientemente que el 43% de los otros 19092 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 19092 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Apple TV MCP?

Superó 2 de 2 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 2 meses, y la última versión (0.2.0) llegó al registro hace 2 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, Claude Flow, Tldraw

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 102 tools.

de koala73Muy usado★ 90,4 milActualizado hace 5 días

Se ejecuta en la nube✓ worldmonitor.app

Instalar

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

de ruvnetMuy usado↓ 13,5 mil/sem★ 81,4 milActualizado hace 14 meses

Se ejecuta en tu computadora

Instalar

Tldraw

Draw and visually collaborate with your agents on tldraw's canvas.

de tldrawMuy usado★ 51,4 milActualizado hace 8 meses

Se ejecuta en la nube

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Apple TV MCP: A local MCP server that lets AI agents control — and see — your Apple TV

Open apps, navigate tvOS, control playback, type searches, adjust volume, manage power, and take screenshots so a multimodal agent can actually inspect what happened.

You:

Open YouTube and search for OpenAI.

Agent: → opens YouTube → takes a screenshot → sees the current interface → navigates to Search → types "OpenAI" → takes another screenshot → verifies the results

Apple TV MCP turns your Apple TV into a locally controlled, visually observable device for MCP-capable AI agents.

No hosted backend. No custom Apple TV app. No cloud account.

Why Apple TV MCP?

Most Apple TV automation is blind.

A script can press Right or Select, but it usually has no idea what appeared on the screen afterward.

Apple TV MCP combines semantic control with point-in-time visual observation.

Traditional Apple TV automation	Apple TV MCP
Send blind remote commands	Take screenshots between actions
Build app-specific scripts	Navigate arbitrary tvOS interfaces
Guess whether an action worked	Inspect the screen and verify
Custom integration per AI system	Standard MCP tool interface
Remote commands only	Apps, playback, text, power, volume, navigation, and vision

The result is a feedback loop an AI agent can actually use:

screenshot

↓ model sees tvOS ↓ chooses an action ↓ press / type / open ↓ screenshot again ↓ verify

Semantic tools are still preferred whenever possible. Screenshots make the difference when the task requires navigating an interface that does not expose a direct API.

Install in seconds

Apple TV MCP requires Python 3.14.

From source

git clone https://github.com/trevor-nichols/appletv-mcp.git

cd appletv-mcp uv sync --locked uv run appletv-mcp configure uv run appletv-mcp doctor uv run appletv-mcp serve

What can it do?

Apple TV MCP exposes fourteen tools grouped around what an agent actually wants to accomplish.

See

Take a screenshot of the current Apple TV screen
Read device, connection, playback, and media state
Inspect available Apple TV capabilities

Apps

List installed applications
Open an application by name
Open an application by bundle identifier
Open deep links and custom application URLs

Navigate

Up
Down
Left
Right
Select
Back
Home
Menu
Other supported remote actions

Remote navigation is intentionally treated as non-idempotent. Apple TV MCP does not blindly replay navigation commands after an uncertain connection failure.

Playback

Play
Pause
Toggle play/pause
Stop
Next
Previous
Seek to an absolute position
Skip forward or backward

Text

Type directly into a focused tvOS text field.

This is useful for:

Search
Usernames
App navigation
Query entry

Volume

Read volume when available
Set an absolute volume level
Adjust volume relatively

Power

Turn the Apple TV on
Turn the Apple TV off

Power operations use different retry semantics so a reconnect attempt cannot accidentally wake a device immediately after a successful power-off command.

Give your agent eyes

The optional screenshot backend is what makes Apple TV MCP more than a remote control.

The MCP tool:

apple_tv_screenshot

returns the current Apple TV screen as native MCP image content.

That means a multimodal MCP client can call the tool and inspect the returned image directly.

For example:

Agent:

apple_tv_screenshot()

→ sees the Apple TV Home Screen → sees YouTube highlighted

apple_tv_press(button="select")

apple_tv_screenshot()

→ sees the YouTube interface

The model does not need access to a local screen.png path and does not receive base64 inside a text response.

The PNG itself is returned through MCP.

Screenshots are point-in-time

Apple TV MCP does not continuously watch the screen.

A screenshot describes what was rendered at the moment it was captured.

If the agent performs another action afterward, the previous screenshot may already be stale.

The intended pattern is:

observe

→ act → observe → verify

Enable screenshots

Screenshot support is optional.

Apple TV control continues to work normally without it.

Install the separate helper:

uv tool install appletv-screenshot

The screenshot system uses a separate Apple developer / RemoteXPC pairing from the pairing used by pyatv.

Pair for developer access:

pymobiledevice3 remote pair

Then configure the screenshot helper for one Apple TV:

appletv-screenshot configure --udid <UDID>

Verify everything together:

appletv-mcp doctor

A healthy installation will report both Apple TV control and screen capture.

The screenshot helper has its own configuration, dependencies, and lifecycle. pymobiledevice3 is not imported by the main appletv-mcp package.

For deeper screenshot setup and transport troubleshooting, see:

sidecars/appletv-screenshot/README.md

Quick start

The complete happy path is:

# Install

uv tool install appletv-mcp

Pair for Apple TV control

atvremote wizard

Choose the Apple TV

appletv-mcp configure

Optional: install visual observation

uv tool install appletv-screenshot

Optional: developer pairing for screenshots

pymobiledevice3 remote pair appletv-screenshot configure --udid

Verify

appletv-mcp doctor

Run the MCP server

appletv-mcp serve

Connect your MCP client

Apple TV MCP uses local stdio MCP transport.

Any MCP client capable of launching a local stdio server can use it.

A typical configuration looks like:

"mcpServers": { "appletv-mcp": { "command": "appletv-mcp", "args": ["serve"] } } }

If Apple TV MCP is running from a cloned repository instead:

"mcpServers": { "appletv-mcp": { "command": "uv", "args": [ "--directory", "/absolute/path/to/appletv-mcp", "run", "appletv-mcp", "serve" ] } } }

The server does not expose an HTTP endpoint and does not require OAuth.

Tools

Tool	Purpose
`apple_tv_status`	Read structured device and playback state
`apple_tv_capabilities`	Inspect normalized feature availability
`apple_tv_list_apps`	List launchable applications
`apple_tv_power`	Turn the Apple TV on or off
`apple_tv_open_app`	Open an application
`apple_tv_open_url`	Open a URL or deep link
`apple_tv_press`	Press Apple TV remote buttons
`apple_tv_playback`	Control playback
`apple_tv_seek`	Seek to an absolute playback position
`apple_tv_skip`	Skip forward or backward
`apple_tv_set_text`	Replace focused keyboard text
`apple_tv_set_volume`	Set an absolute volume
`apple_tv_adjust_volume`	Adjust volume relatively
`apple_tv_screenshot`	Return one screenshot as MCP image content

The screenshot tool is the only tool that returns image content rather than a structured result.

How it works

Apple TV MCP keeps control and visual observation intentionally separate.

                         AI Agent

│ ▼ Apple TV MCP / \ / \ ▼ ▼ semantic control screen capture │ │ pyatv appletv-screenshot │ │ │ pymobiledevice3 │ │ │ RemoteXPC / DVT │ │ └──── Apple TV ─┘

Control

Apple TV control is provided through pyatv.

Apple TV MCP adds a semantic application layer on top for:

deterministic app resolution
capability checking
connection lifecycle
safe retry behavior
non-idempotent command protection
normalized MCP results

The stable Apple TV identifier is authoritative.

The last known IP address is only an optimization. If the Apple TV changes addresses, Apple TV MCP can rediscover it by identifier and update the preferred host.

Vision

Screenshots use the separate appletv-screenshot helper.

The helper uses pymobiledevice3 to reach Apple's developer services over RemoteXPC and request a screenshot through DVT.

Its default transport strategy is:

macOS:

native → userspace → tunneld

Linux / Windows: userspace → tunneld

The normal Wi-Fi userspace path does not require root or a permanently running tunnel daemon.

The helper exists as a separate process so its protocol stack, dependencies, pairing records, and failure modes remain isolated from Apple TV control.

pymobiledevice3 is confined to the separately distributed appletv-screenshot helper. The main appletv-mcp package does not import or bundle it; the two processes communicate through a narrow command-line/file contract.

Designed for agents

The MCP interface intentionally exposes semantic operations rather than raw Apple protocols.

An agent should think:

open YouTube

pause playback seek to 2:00 type "Severance" set volume to 35% take a screenshot

not:

send Companion command

call MRP endpoint construct RemoteXPC request

When a semantic operation exists, use it.

Visual navigation is the fallback for interfaces that require it.

Privacy and security

Apple TV MCP is designed to remain local.

No hosted Apple TV MCP backend
No cloud account
MCP uses local stdio transport
Apple TV pairing credentials stay on the user's machine
RemoteXPC pairing records stay with the screenshot helper
Credentials are never MCP parameters
Credentials are never returned to the model
Keyboard text is not emitted into normal logs
Screenshots are captured only when explicitly requested
Screenshot bytes are not logged
Screenshots are stored only in a private temporary directory during capture
Temporary screenshot files are deleted after the MCP result is created
Screenshot capture does not run automatically after commands
The helper is launched without a shell
No DRM circumvention is attempted

Debug mode also keeps raw pyatv protocol logging disabled because low-level Companion traffic can contain sensitive keyboard and pairing payloads.

Protected video

Streaming applications may protect video using DRM.

In that case, screenshots can contain:

black video

blank video redacted video

while menus or playback contro

Solo se muestra el principio; lee el resto en el repo

Apple TV MCP

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Qué apps pueden usarlo

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

World Monitor

Claude Flow

Tldraw

README del creador

Apple TV MCP: A local MCP server that lets AI agents control — and see — your Apple TV

Why Apple TV MCP?

Install in seconds

Recommended

From source

What can it do?

See

Apps

Navigate

Playback

Text

Volume

Power

Give your agent eyes

Screenshots are point-in-time

Enable screenshots

Quick start

Pair for Apple TV control

Choose the Apple TV

Optional: install visual observation

Optional: developer pairing for screenshots

Verify

Run the MCP server

Connect your MCP client

Tools

How it works

Control

Vision

Designed for agents

Privacy and security

Protected video