The mpchc platform allows you to connect a Media Player Classic Home Cinema to Home Assistant. It will allow you to see the current playing item, and respond to changes in the player’s state.

For this component to function, you will need to enable the Web Interface in the MPC-HC options dialog.

If the server running Home Assistant is not the same device that is running MPC-HC, you will need to ensure that the allow access from localhost only option is not set.

The MPC-HC web interface is highly insecure, and allows remote clients full player control file-system access without authentication. Never allow access to the Web UI from outside of your trusted network, and if possible use a proxy script to restrict control or redact sensitive information.

To add MPC-HC to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
  - platform: mpchc

Configuration Variables


(string)(Required)The host name or IP address of the device that is running MPC-HC.


(integer)(Optional)The port number of the device.

Default value: 13579


(string)(Optional)The name of the device used in the frontend.

Default value: MPC-HC