Apple TV MCP

Name: Apple TV MCP
Author: trevor-nichols

作者：trevor-nicholsバージョン 0.2.0i★ 1iパソコンで動く

レジストリ名io.github.trevor-nichols/appletv-mcp

インストール

概要

作者による説明（英語の原文）

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

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi2項目中2項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況iとても新しい↓ 41/週 · ★ 1

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: その他

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：2項目中2項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
レジストリには、入力が必要なキーは載っていません。

必要なもの

PyPIPythonのuvのインストール（uvxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

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

ターミナルでこれを実行します

claude mcp add appletv -- uvx appletv-mcp serve

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

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

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

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

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

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

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月11日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント trevor-nichols で確認済みです
✓ 合格
今もメンテナンスされている
コードの最終更新：2 か月前
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

このカテゴリのほかの19101件のうち82%よりスターが多い
このカテゴリのほかの19101件のうち43%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの19101件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Apple TV MCPは安全ですか？

当てはまる基本チェック2項目のうち2項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は2 か月前、最新バージョン（0.2.0）がレジストリに届いたのは2 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは？

同じカテゴリには：World Monitor, Claude Flow, Tldraw

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

World Monitor

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

作者：koala73広く使われている★ 9万6 日前更新

クラウドで動く✓ worldmonitor.app

インストール

Claude Flow

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

作者：ruvnet広く使われている↓ 1.4万/週★ 8.1万14 か月前更新

パソコンで動く

インストール

Tldraw

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

作者：tldraw広く使われている★ 5.1万8 か月前更新

クラウドで動く

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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

冒頭だけを表示しています。続きはリポジトリで読めます

Apple TV MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

使えるアプリ

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

その他のほかのサーバーとの比較i

よくある質問

代わりの候補

World Monitor

Claude Flow

Tldraw

作者のREADME

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