mcp-pyatv

# mcp-pyatv MCP server for controlling Apple TV, HomePod, and AirPlay devices via [pyatv](https://github.com/postlund/pyatv).   --- ## What It Does mcp-pyatv is an [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that bridges any MCP client to Apple TV, HomePod, and AirPlay devices on your local network. It wraps [pyatv](https://github.com/postlund/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. ## Supported Devices - **Apple TV** -- all generations, including tvOS 15+ - **HomePod / HomePod Mini** - **AirPort Express** - **Third-party AirPlay speakers** - **macOS** (Music/iTunes) ## Quick Start ### Install ```bash pip install mcp-pyatv ``` Or run directly without installing: ```bash uvx mcp-pyatv ``` ### Claude Desktop Configuration Add this to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS): ```json { "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"] > } > } > } > ``` ### Local Development If you've cloned the repo and want to ru…