{"type":"mcp_server","name":"homeassistant-mcp","description":"This repository provides a Model Context Protocol (MCP) server for Home Assistant, enabling natural language control and monitoring of smart home devices through an API with real-time updates and secure authentication.","category":"System Tools","language":"TypeScript","stars":573,"forks":5,"owner":"tevonsb","github_url":"https://github.com/tevonsb/homeassistant-mcp","homepage":null,"setup":"## Setup\n\n**Basic Setup**\n\n1.  Clone the repository:\n    ```bash\n    git clone https://github.com/jango-blockchained/homeassistant-mcp.git\n    cd homeassistant-mcp\n    ```\n2.  Install dependencies:\n    ```bash\n    npm install\n    ```\n3.  Build the project:\n    ```bash\n    npm run build\n    ```\n\n**Docker Setup (Recommended)**\n\n1.  Clone the repository:\n    ```bash\n    git clone https://github.com/jango-blockchained/homeassistant-mcp.git\n    cd homeassistant-mcp\n    ```\n2.  Configure environment:\n    ```bash\n    cp .env.example .env\n    ```\n    Edit the `.env` file with your Home Assistant configuration.\n3.  Build and run with Docker Compose:\n    ```bash\n    # Build and start the containers\n    docker compose up -d\n\n    # View logs\n    docker compose logs -f\n\n    # Stop the service\n    docker compose down\n    ```\n4.  Verify the installation: The server should now be running at `http://localhost:3000`.\n5.  Update the application:\n    ```bash\n    # Pull the latest changes\n    git pull\n\n    # Rebuild and restart the containers\n    docker compose up -d --build\n    ```","tools":"## Available Tools\n\n1.  Device Control (Control any Home Assistant device through natural language)\n2.  Real-time Updates (Get instant updates through Server-Sent Events (SSE))\n3.  Automation Management (Create, update, and manage automations)\n4.  State Monitoring (Track and query device states)\n5.  Secure (Token-based authentication and rate limiting)\n6.  Mobile Ready (Works with any HTTP-capable client)\n7.  Add-on Management (Browse, install, uninstall, start, stop, restart add-ons, manage versions, and access configuration)\n8.  Package Management (HACS) (Integration with Home Assistant Community Store with version control and updates)\n9.  Intelligent Organization (Area and floor-based device grouping with smart context awareness)\n10. Robust Architecture (Comprehensive error handling, state validation, secure API integration, TypeScript type safety, and extensive test coverage)","faq":null,"created_at":"2024-12-12T06:30:27+00:00","updated_at":"2025-03-28T17:11:45+00:00","source_url":"https://model-context-protocol.com/servers/homeassistant-mcp","related_articles":[]}