Apple TV MCP server
io.github.trevor-nichols/appletv-mcp·v0.2.0Local MCP server for semantic Apple TV control with optional screenshots.
0 stars125 downloads/wk
Reviews
Write oneNobody has reviewed Apple TV MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Apple TV MCP tools (14)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
apple_tv_adjust_volumeNudge volume up or down. Relative steps are not retried after uncertain failure.
apple_tv_capabilitiesReturn current availability of semantic Apple TV operations.
apple_tv_list_appsList launchable applications installed on the Apple TV.
apple_tv_open_appLaunch an installed application by exact bundle ID or exact display name.
apple_tv_open_urlAsk the Apple TV to open a URL or application deep link.
apple_tv_playbackControl playback with play, pause, toggle, stop, next, or previous.
apple_tv_powerTurn the Apple TV on or off and report the observed power state.
apple_tv_pressPress a remote button. Navigation is non-idempotent.
apple_tv_screenshotCapture the Apple TV screen as one PNG image.
apple_tv_seekSeek to an absolute playback position in seconds.
apple_tv_set_textReplace text in a focused Apple TV text field.
apple_tv_set_volumeSet absolute volume percent when the device supports volume control.
apple_tv_skipSkip forward or backward. Relative skips are not retried after uncertain failure.
apple_tv_statusRead current device, power, playback, volume, and keyboard state.
Public scan report
scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it
- Code scan72 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 21 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Apple TV MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 93% of 48,243 servers
- Tools
- 14
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 125
- more than 67% of 12,306 servers with a package
What its tools let an agent do: 14 read
Install Apple TV MCP in Claude Code, Cursor or VS Code
claude mcp add appletv-mcp -- uvx appletv-mcp
What the publisher says
From the Apple TV MCP repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.trevor-nichols/appletv-mcp -->
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 resultsApple 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.
The result is a feedback loop an AI agent can actually use:
screenshot
↓
model sees tvOS
↓
chooses an action
↓
press / type / open
↓
screenshot again
↓
verifySemantic 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.
Recommended
uv tool install appletv-mcpOr:
pipx install appletv-mcpThen pair your Apple TV:
atvremote wizardConfigure Apple TV MCP:
appletv-mcp configureCheck the setup:
appletv-mcp doctorAnd start the MCP server:
appletv-mcp serveFrom 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 serveWhat 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
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Apple TV MCP: common questions
- Is Apple TV MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Apple TV MCP safety report
- How do I install Apple TV MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Apple TV MCP need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Apple TV MCP maintained?
- The last commit was 54 days ago (2026-09-12). The latest release is v0.2.0.
- What can I use instead of Apple TV MCP?
- Servers from other publishers that do the same job: Canvas MCP server.
- How does Apple TV MCP compare with other MCP servers?
- safety score 92/100 (higher than 93% of 48,243 servers); tools 14 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Apple TV MCP
Same job from other publishers: the closest match first, then the best rated.
- CanvasCanvas LMS integration for students and educators with optional privacy controlsnot reviewedEstablishedA