Skip to content

Releases: trevor-nichols/appletv-mcp

Release list

v0.2.0

v0.2.0 Latest
Latest

Choose a tag to compare

View all tags
@trevor-nichols trevor-nichols released this 12 Sep 13:40
v0.2.0
0874c01

First public release of Apple TV MCP. There is no published 0.1.0; this is the version to install.

Apple TV MCP is a local stdio MCP server for semantic Apple TV control. An agent can open apps, manage power, control playback, type into a focused field, adjust volume, and press the remote — then take a point-in-time screenshot to inspect what tvOS actually rendered.

Packages

  • appletv-mcp (MIT) — MCP server and CLI (appletv-mcp serve)
  • appletv-screenshot (GPL-3.0-or-later) — optional helper; install separately if you want apple_tv_screenshot
uv tool install appletv-mcp
uv tool install appletv-screenshot

Highlights

  • Fourteen MCP tools for power, apps, playback, text, volume, remote, status, capabilities, and screenshots
  • Semantic control first; remote navigation is blind and not retried after an uncertain failure
  • Screenshots are optional, one PNG at a time, returned as native MCP image content
  • Local only: no hosted backend, no custom Apple TV app, no cloud account
  • Screen capture uses a separate process so pymobiledevice3 is never imported by the MCP package

Limits

  • One configured Apple TV
  • Screenshots are stale as soon as another action runs
  • Protected DRM video may appear black; that does not mean the TV is off
  • media_app is the app associated with current media, not a guaranteed foreground app
  • Pairing is setup (atvremote wizard, plus a separate developer pairing for screenshots), not an MCP tool
Assets 2
Loading