Home Assistant MCP Server
A Model Context Protocol (MCP) server for interacting with Home Assistant. This server provides tools to control and monitor your Home Assistant devices through MCP-enabled applications.
This project is part of the AI Model Context Protocol (MCP) ecosystem. For more information and documentation about MCP tools, visit www.aimcp.info.
Features
- Get device states
- Control device states (on/off)
- Trigger automations
- List available entities
Installation
- Clone this repository:
- Install dependencies:
- Build the project:
- Configure the MCP server by adding the following to your MCP settings file (typically located at
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonfor VSCode):
Replace
your-homeassistant-url and your-long-lived-access-token with your Home Assistant instance URL and access token.Usage
The server provides the following tools:
1. Get Device State
2. Toggle Device State
3. Trigger Automation
4. List Entities
Contributing
Contributions are welcome! Here's how you can help:
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add some amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- Open a Pull Request
Please make sure to update tests as appropriate and follow the existing code style.
Documentation
For detailed documentation about MCP tools and the ecosystem:
- Visit www.aimcp.info
- Check the MCP tools directory on the website
- Read the integration guides and best practices
License
This project is licensed under the MIT License - see below for details:
Security
To securely use this server:
- Always use HTTPS for your Home Assistant instance
- Keep your access tokens secure and never commit them to version control
- Regularly rotate your access tokens
- Use environment variables for sensitive information
Support
If you encounter any issues or have questions, please:
- Check the existing issues in the repository
- Create a new issue if your problem hasn't been reported
- Provide as much context as possible when reporting issues
- Visit www.aimcp.info for additional support resources
Home Assistant MCP Server
A Model Context Protocol (MCP) server for interacting with Home Assistant. This server provides tools to control and monitor your Home Assistant devices through MCP-enabled applications.
This project is part of the AI Model Context Protocol (MCP) ecosystem. For more information and documentation about MCP tools, visit www.aimcp.info.
Features
- Get device states
- Control device states (on/off)
- Trigger automations
- List available entities
Installation
- Clone this repository:
- Install dependencies:
- Build the project:
- Configure the MCP server by adding the following to your MCP settings file (typically located at
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonfor VSCode):
Replace
your-homeassistant-url and your-long-lived-access-token with your Home Assistant instance URL and access token.Usage
The server provides the following tools:
1. Get Device State
2. Toggle Device State
3. Trigger Automation
4. List Entities
Contributing
Contributions are welcome! Here's how you can help:
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add some amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- Open a Pull Request
Please make sure to update tests as appropriate and follow the existing code style.
Documentation
For detailed documentation about MCP tools and the ecosystem:
- Visit www.aimcp.info
- Check the MCP tools directory on the website
- Read the integration guides and best practices
License
This project is licensed under the MIT License - see below for details:
Security
To securely use this server:
- Always use HTTPS for your Home Assistant instance
- Keep your access tokens secure and never commit them to version control
- Regularly rotate your access tokens
- Use environment variables for sensitive information
Support
If you encounter any issues or have questions, please:
- Check the existing issues in the repository
- Create a new issue if your problem hasn't been reported
- Provide as much context as possible when reporting issues
- Visit www.aimcp.info for additional support resources