Skip to main content
Glama

MCP Media Player

You could just watch one episode. Or you could automate the pause button and pretend you have self-control. MCP Media Player connects any Home Assistant media player (TV, projector, speaker, etc.) to the Cursor coding environment. Play media while your agent works; when it's done, so is your break.

Dopamine-driven development, minus the binge-watching.

Features

  • Exposes play and pause controls for a media player as MCP tools

  • Integrates with Home Assistant's media player API

  • Provides Cursor rules for automating playback while the agent is working

Requirements

  • Node.js 18 or higher (for native fetch and ES modules)

  • A running Home Assistant instance

  • A valid Home Assistant long-lived access token

Setup

  1. Clone the repository

  2. Install dependencies

npm install
  1. Configure MCP integration

Copy mcp.json.example to your MCP config location (e.g., ~/.cursor/mcp.json) and fill in your real values:

{ "mcpServers": { "MediaPlayer": { "command": "node", "args": [ "/absolute/path/to/your/media-player-mcp.js" ], "env": { "HA_URL": "http://your-ha-url:8123", "HA_TOKEN": "your_home_assistant_long_lived_token", "ENTITY_ID": "media_player.your_media_player_entity" } } } }
  1. Add Cursor rules for automation

To automate the play/pause while the agent is working, copy the rules in cursor-rules.example into your Cursor rules configuration. This configures a system prompt rule that ensures the play/pause tools are called at the appropriate times.

  1. Start the MCP server

npm start

Or, let your MCP client launch it automatically.

License

MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/danielsims/mcp-media-player'

If you have feedback or need assistance with the MCP directory API, please join our Discord server