mcp-pyatv

MCP server for controlling Apple TV, HomePod, and AirPlay devices via pyatv.

---

mcp-pyatv is an MCP (Model Context Protocol) server that bridges any MCP client to Apple TV, HomePod, and AirPlay devices on your local network. It wraps pyatv -- the open-source Python library that implements the actual Apple TV and AirPlay protocols -- and exposes its functionality as MCP tools.

This lets you control your devices using natural language through Claude Desktop, Claude Code, Cursor, or any other MCP-compatible client.

This project does not implement any device protocols. All protocol-level communication is handled by pyatv. mcp-pyatv is purely the MCP bridge layer.

• Apple TV -- all generations, including tvOS 15+
• HomePod / HomePod Mini
• AirPort Express
• Third-party AirPlay speakers
• macOS (Music/iTunes)

pip install mcp-pyatv

Or run directly without installing:

uvx mcp-pyatv

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "apple-tv": {
      "command": "uvx",
      "args": ["--python", "python3.13", "mcp-pyatv"]
    }
  }
}

> Note: Claude Desktop may not inherit your shell's PATH. If you get a "command not found" error, use the full path to uvx (run which uvx in your terminal to find it): > > ``json > { > "mcpServers": { > "apple-tv": { > "command": "/Users/you/.local/bin/uvx", > "args": ["--python", "python3.13", "mcp-pyatv"] > } > } > } > ``

If you've cloned the repo and want to run