hekmon8/Homeassistant-server-mcp

## 🌟 Sponsors
| Website | Description |
| ProductDirs.com | AI Tools Directory & Launch Platform - Free submission service for discovering and promoting AI SaaS products, startups, and developer tools with community-driven rankings |
| ThisTools.app | AI SaaS Discovery Platform - Free listing directory for artificial intelligence software, automation tools, and productivity applications with curated collections |
| AIImgCombiner.com | AI-Powered Image Fusion Tool - Free online service for merging and combining photos using artificial intelligence with preset styles and custom prompts for professional results |
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
### Installing via Smithery
To install Home Assistant MCP Server for Claude Desktop automatically via Smithery:
bash
npx -y @smithery/cli install @hekmon8/Homeassistant-server-mcp --client claude
### Manual Installation
1. Clone this repository:
bash
git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp
2. Install dependencies:
bash
npm install
3. Build the project:
bash
npm run build
4. 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/clinemcpsettings.json for VSCode):
json
"mcpServers": {
"homeassistant": {
"command": "node",
"args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
"env": {
"HAURL": "http://your-homeassistant-url:8123",
"HATOKEN": "your-long-lived-access-token"
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
typescript
// Example usage
usemcptool({
servername: "homeassistant",
toolname: "getstate",
arguments: {
entityid: "light.livingroom"
});
### 2. Toggle Device State
typescript
// Example usage
usemcptool({
servername: "homeassistant",
toolname: "toggleentity",
arguments: {
entityid: "switch.bedroom",
state: "on" // or "off"
});
### 3. Trigger Automation
typescript
// Example usage
usemcptool({
servername: "homeassistant",
toolname: "triggerautomation",
arguments: {
automationid: "automation.morningroutine"
});
### 4. List Entities
typescript
// Example usage
usemcptool({
servername: "homeassistant",
toolname: "listentities",
arguments: {
domain: "light" // optional, filters by domain
});
## Contributing
Contributions are welcome! Here's how you can help:
1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')