@coffeerunhobby/mcp-ha-connect

v1.7.1

Published

6 days ago

Smart home MCP server for Home Assistant plus Local AI integration

0High
0Medium
0Low

coffeerunhobby

mcp home-assistant home-automation smart-home

MCP-HA-Connect

A production-ready Model Context Protocol (MCP) server for Home Assistant integration with AI assistants like Claude and LM Studio.

See docs/QUICK_START.md for Docker, HTTP server mode, n8n integration, and more installation options.

Key Features

Core Functionality

Smart Device Control
Lights: Brightness, color temperature, RGB color, transitions
Climate: Temperature, HVAC modes, fan modes, humidity
Covers: Position and tilt control
Switches: On/off control
Sensors & Contacts: State monitoring
Media Players: Playback control, volume, source selection
Fans: Speed, oscillation, direction
Locks: Lock/unlock control
Vacuums: Start, stop, return to base
Cameras: Motion detection, snapshots

Automation Management

List all automations with status
Trigger automations manually with variables
Enable/disable/toggle automations
Create new automations via API
Delete automations
View automation execution traces
Reload automations from configuration

System Features

Direct Home Assistant API integration
Long-lived access token authentication
Entity state management
Service call support
Advanced entity search
AI-powered sensor analysis with Ollama
Multiple transport modes (stdio, Streamable HTTP)
HTTP server with health checks
CORS support for browser-based clients
Structured logging (plain, JSON, GCP-JSON formats)
Comprehensive configuration validation with Zod
Full type safety with TypeScript
Stateful and stateless session support
JWT authentication with role-based access control
MCP Server Instructions for improved LLM tool selection

Network Monitoring & Security (TP-Link Omada)

Bring your home network into the same assistant that runs your home. These are the high-value questions an LLM can actually answer about your network:

Internet & WAN status — "Is my internet up? What's my WAN IP and uplink speed?" Live per-WAN status, plus multi-WAN / ISP health and load-balancing for the gateway.
Event & alert logs — "What happened on my network?" The site event and alert logs, time-windowed (defaults to the last 7 days), to correlate with Home Assistant history.
Wireless security — rogue-AP scan results and (on Omada Pro) wireless intrusion detection (WIDS) for genuine network-security awareness.
Controller & device health — dashboard overview plus top devices by CPU and memory usage, HA-style monitoring of your network stack.
Speed tests — surface the controller's own speed-test results, pairing with AI-powered analyzeSensors for anomaly detection.
Pending devices — "Is there a new device waiting to be adopted?"
Firmware awareness — per-device firmware info and a controller-wide critical-upgrade overview, mirroring the Home Assistant checkUpdates philosophy across the network.
Client management — list/inspect connected clients, traffic activity, and apply rate-limit profiles, with presence correlation against Home Assistant device trackers.

A discoverable resource-graph mode (MCP_TOOL_REGISTRATION_MODE=graph) exposes all of the above through two tools — omada_browse + omada_read — keeping the tool-schema budget small for low-context models. See the Omada tool tables below for the full eager surface.

Available Tools (60 Total)

Home Assistant Tools (35)

State & Entity Tools

| Tool | Description | |------|-------------| | getStates | Get all entity states (paginated, 50/page default). Use includeAttributes=true for full data | | getState | Get the state of a specific entity by entity_id | | getEntitiesByDomain | Get entities for a domain (paginated, 50/page default). Use includeAttributes=true for full data | | searchEntities | Search entities by name/entity_id (paginated, 50/page default). Use includeAttributes=true for full data | | getAllSensors | Get all sensors (paginated, 50/page default). Use includeAttributes=true for full data | | listEntities | List entities with filtering (domain, state, search, limit). Use includeAttributes=true for full data | | getDomainSummary | Get summary statistics for a domain | | getHistory | Get historical data for an entity | | listPersons | List all household members with location state (home/away) |

Service & Control Tools

| Tool | Description | |------|-------------| | callService | Call any Home Assistant service | | entityAction | Simple turn_on/turn_off/toggle actions |

Device Control Tools

| Tool | Description | |------|-------------| | controlLight | Control lights with brightness, color, temperature | | controlClimate | Control thermostats with temperature, HVAC mode | | controlMediaPlayer | Control media players with playback, volume | | controlCover | Control covers/blinds with position, tilt | | controlFan | Control fans with speed, oscillation, direction | | activateScene | Activate a Home Assistant scene | | runScript | Run a Home Assistant script | | sendNotification | Send notifications with full mobile app support (actions, priority, images) | | listNotificationTargets | Discover available mobile app notification targets |

Automation Tools

| Tool | Description | |------|-------------| | listAutomations | List all automations with status | | triggerAutomation | Manually trigger an automation | | enableAutomation | Enable a disabled automation | | disableAutomation | Disable an automation | | toggleAutomation | Toggle automation state | | reloadAutomations | Reload automations from config | | createAutomation | Create a new automation | | deleteAutomation | Delete an automation | | getAutomationTrace | Get automation execution history |

System Tools

| Tool | Description | |------|-------------| | getVersion | Get Home Assistant version and config info | | restartHomeAssistant | Restart the Home Assistant server | | getSystemLog | Get system log entries from logbook | | checkUpdates | Check for available updates |

Calendar Tools

| Tool | Description | |------|-------------| | listCalendars | List all calendar entities | | getCalendarEvents | Get events from one or all calendars |

Omada Network Tools (24)

Device Tools

| Tool | Description | |------|-------------| | omada_listDevices | List all network devices (APs, switches, gateways) in a site | | omada_getDevice | Get detailed information about a specific network device | | omada_searchDevices | Search for devices globally across all sites | | omada_getSwitchStackDetail | Get detailed information about a switch stack | | omada_listDevicesStats | Get statistics for global adopted devices with filtering |

Client Tools

| Tool | Description | |------|-------------| | omada_listClients | List all connected clients (devices/users) in a site | | omada_getClient | Get detailed information about a specific connected client | | omada_listMostActiveClients | Get the most active clients sorted by total traffic | | omada_listClientsActivity | Get client activity statistics over time | | omada_listClientsPastConnections | Get historical client connection data |

Rate Limit Tools

| Tool | Description | |------|-------------| | omada_getRateLimitProfiles | Get available rate limit profiles for a site | | omada_setClientRateLimit | Set custom bandwidth limits for a client (download/upload in Kbps) | | omada_setClientRateLimitProfile | Apply a rate limit profile to a client | | omada_disableClientRateLimit | Remove bandwidth limits from a client |

Security Tools

| Tool | Description | |------|-------------| | omada_getThreatList | Get security threat management list |

Network Configuration Tools

| Tool | Description | |------|-------------| | omada_getInternetInfo | Get internet connection configuration for a site | | omada_getPortForwardingStatus | Get port forwarding rules (User or UPnP) | | omada_getLanNetworkList | Get LAN network configuration list | | omada_getLanProfileList | Get LAN profile configuration list | | omada_getWlanGroupList | Get WLAN group configuration list | | omada_getSsidList | Get SSID list for a WLAN group | | omada_getSsidDetail | Get detailed SSID configuration | | omada_getFirewallSetting | Get firewall configuration for a site |

AI Tools (1)

| Tool | Description | |------|-------------| | analyzeSensors | Analyze sensor data using AI (Ollama) to detect issues and provide recommendations |

MCP Resources

| Resource URI | Description | |--------------|-------------| | hass://entities | List all entities grouped by domain | | hass://entities/{entity_id} | Get state of a specific entity | | hass://entities/{entity_id}/detailed | Get detailed entity info with all attributes | | hass://entities/domain/{domain} | Get all entities for a domain | | hass://search/{query}/{limit} | Search entities with result limit |

Prerequisites

Node.js 20+ (tested with v20.19.6) - for npm/npx methods
npm 10.8+ (tested with v10.8.2) - for npm/npx methods
Docker (optional) - for Docker method
Home Assistant instance with long-lived access token
Network access to your Home Assistant instance
(Optional) Ollama for AI-powered analysis

Getting Your Home Assistant Token

Log into your Home Assistant instance
Click on your profile (bottom left)
Scroll down to "Long-Lived Access Tokens"
Click "Create Token"
Give it a name (e.g., "MCP Server")
Copy the token (shown only once!)

Environment Variables

Required

| Variable | Description | Example | |----------|-------------|---------| | HA_URL | Home Assistant URL | http://homeassistant.10.0.0.19.nip.io:8123 | | HA_TOKEN | Long-lived access token | eyJhbGciOiJIUzI1NiIsInR5cCI... |

Optional - Home Assistant

| Variable | Default | Description | |----------|---------|-------------| | HA_PLUGIN_ENABLED | true | Enable Home Assistant plugin | | HA_STRICT_SSL | true | Validate SSL certificates | | HA_TIMEOUT | 30000 | API request timeout (ms) |

Optional - MCP Server

| Variable | Default | Description | |----------|---------|-------------| | MCP_SERVER_LOG_LEVEL | info | Log level: debug, info, warn, error | | MCP_SERVER_LOG_FORMAT | plain | Log format: plain, json, gcp-json | | MCP_SERVER_USE_HTTP | false | Enable HTTP mode (vs stdio) | | MCP_SERVER_STATEFUL | false | Enable stateful sessions in HTTP mode |

Optional - HTTP Mode

| Variable | Default | Description | |----------|---------|-------------| | MCP_HTTP_PORT | 3000 | HTTP server port | | MCP_HTTP_BIND_ADDR | 127.0.0.1 | Bind address | | MCP_HTTP_PATH | /mcp | MCP endpoint path | | MCP_HTTP_ENABLE_HEALTHCHECK | true | Enable health check endpoint | | MCP_HTTP_HEALTHCHECK_PATH | /health | Health check path | | MCP_HTTP_ALLOW_CORS | true | Enable CORS | | MCP_HTTP_ALLOWED_ORIGINS | 127.0.0.1,localhost | Allowed CORS origins |

Optional - Chat face (OpenAPI/REST surface)

The server also serves an OpenAPI/REST face (/openapi.json + /api/*) for chat UIs like Open WebUI. By default it exposes the classic 8 Home Assistant tools. Tools marked chat-eligible in code can be activated per category with read/write granularity:

| Variable | Default | Description | |----------|---------|-------------| | MCP_CHAT_TOOLS | unset (= legacy 8 HA tools) | Category slice, e.g. ha-core:rw,ha-history:r,omada-read:r. Categories: ha-core, ha-history, ha-automations, omada-read, omada-write. Config can only narrow what the code marks chat-eligible; ADMIN tools (invokeAction) can never appear on this face. | | MCP_REST_ACTIONS | unset (= tool not registered) | JSON map of pre-registered REST actions for the invokeAction MCP tool (ADMIN; MCP face only), e.g. {"deploy":{"url":"http://host:8425/v1/update","bearerToken":"...","cooldownMs":300000}}. Each action is rate-limited: min interval between firings = cooldownMs (default 60000; 0 disables) — caps deploy-storm blast radius if a model loops a legitimate action |

Activated chat tools appear in the generated /openapi.json as POST /api/tools/<name> and dispatch through the same handlers, validation, and RBAC as the MCP face.

Optional - SSE Events

| Variable | Default | Description | |----------|---------|-------------| | MCP_SSE_EVENTS_ENABLED | false | Enable real-time SSE events | | MCP_SSE_EVENTS_PATH | /subscribe_events | SSE endpoint path |

Optional - Rate Limiting

| Variable | Default | Description | |----------|---------|-------------| | MCP_RATE_LIMIT_ENABLED | false | Enable rate limiting | | MCP_RATE_LIMIT_WINDOW_MS | 60000 | Rate limit window (ms) | | MCP_RATE_LIMIT_MAX_REQUESTS | 100 | Max requests per window |

Optional - Authentication

| Variable | Default | Description | |----------|---------|-------------| | MCP_AUTH_METHOD | none | Auth method: none or bearer | | MCP_AUTH_SECRET | - | JWT signing secret (min 32 chars, required for bearer method) | | MCP_PERMISSIONS_CONFIG | - | JSON config for user roles and permissions |

JWT Authentication

When MCP_AUTH_METHOD=bearer, clients must provide a JWT token in the Authorization header:

Authorization: Bearer <jwt-token>

Generate tokens with your MCP_AUTH_SECRET using HS256 algorithm. The JWT payload should include:

sub (subject): User identifier for permission lookup
exp (optional): Expiration timestamp

Permission System

The server uses role-based access control with binary permission masks:

| Permission | Flag | Description | |------------|------|-------------| | ADMIN | 1 | System operations (restart, updates) | | CONFIGURE | 2 | Create/modify automations, scripts | | CONTROL | 4 | Control devices (lights, climate, etc.) | | QUERY | 8 | Read entity states, history, lists | | NOTIFY | 16 | Send notifications | | AI | 32 | Use AI analysis features |

Predefined Roles:

| Role | Permissions | |------|-------------| | NONE | No permissions | | READONLY | QUERY only | | OPERATOR | QUERY + CONTROL + NOTIFY | | CONTRIBUTOR | QUERY + CONTROL + NOTIFY + CONFIGURE | | ADMIN | All except AI | | SUPERUSER | All permissions |

Configuration Example:

{
  "users": [
    { "sub": "[email protected]", "role": "admin" },
    { "sub": "[email protected]", "role": "operator" },
    { "sub": "[email protected]", "role": "readonly" }
  ],
  "defaultRole": "NONE"
}

Set via environment variable (escape quotes for shell):

MCP_PERMISSIONS_CONFIG='{"users":[{"sub":"admin","role":"admin"}],"defaultRole":"NONE"}'

Optional - AI Provider

| Variable | Default | Description | |----------|---------|-------------| | AI_PLUGIN_ENABLED | true | Enable AI plugin | | AI_PROVIDER | ollama | AI provider: ollama, openai, or none | | AI_URL | http://localhost:11434 | AI server URL (Ollama) | | AI_MODEL | llama2 | AI model name | | AI_TIMEOUT | 60000 | AI request timeout (ms) |

Optional - Omada Network Controller

| Variable | Default | Description | |----------|---------|-------------| | OMADA_PLUGIN_ENABLED | false | Enable Omada plugin | | OMADA_BASE_URL | - | Omada controller URL (e.g., https://192.168.0.1:8043) | | OMADA_CLIENT_ID | - | OAuth2 client ID from Omada controller | | OMADA_CLIENT_SECRET | - | OAuth2 client secret from Omada controller | | OMADA_OMADAC_ID | - | Omada controller ID | | OMADA_SITE_ID | - | Default site ID for operations | | OMADA_STRICT_SSL | true | Validate SSL certificates | | OMADA_TIMEOUT | 30000 | API request timeout (ms) |

Advanced Configuration Examples

With AI Analysis (Ollama)

{
  "mcpServers": {
    "homeassistant": {
      "command": "npx",
      "args": ["-y", "@coffeerunhobby/mcp-ha-connect"],
      "env": {
        "HA_URL": "http://homeassistant.10.0.0.19.nip.io:8123",
        "HA_TOKEN": "your_token",
        "AI_PROVIDER": "ollama",
        "AI_URL": "http://ollama.10.0.0.17.nip.io:11434",
        "AI_MODEL": "llama2"
      }
    }
  }
}

Disable AI Features

{
  "mcpServers": {
    "homeassistant": {
      "command": "npx",
      "args": ["-y", "@coffeerunhobby/mcp-ha-connect"],
      "env": {
        "HA_URL": "http://homeassistant.10.0.0.19.nip.io:8123",
        "HA_TOKEN": "your_token",
        "AI_PROVIDER": "none"
      }
    }
  }
}

Docker with Network Configuration

For Linux, you may need to add host.docker.internal:

{
  "mcpServers": {
    "homeassistant": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--add-host=host.docker.internal:host-gateway",
        "-e", "HA_URL=http://host.docker.internal:8123",
        "-e", "HA_TOKEN=your_token",
        "ghcr.io/coffeerunhobby/mcp-ha-connect:latest"
      ]
    }
  }
}

Usage Modes

Mode 1: MCP Client (Claude Desktop / LM Studio)

Default stdio mode for MCP clients. See Quick Start section for configuration.

For detailed configuration options, see docs/LOCAL_CLIENT.md.

Mode 2: HTTP Server

Start as standalone HTTP server for web applications:

# Using npx
npx @coffeerunhobby/mcp-ha-connect

# Or with environment variables
MCP_SERVER_USE_HTTP=true \
MCP_HTTP_PORT=3000 \
HA_URL=http://homeassistant.10.0.0.19.nip.io:8123 \
HA_TOKEN=your_token \
npx @coffeerunhobby/mcp-ha-connect

Streamable HTTP Transport

Configure your MCP client to use:

URL: http://localhost:3000/mcp
Transport: Streamable HTTP (MCP 2025-03-26)

SSE Event Subscription

Subscribe to real-time events:

const eventSource = new EventSource(
  'http://localhost:3000/subscribe_events?domain=light&entity_id=light.living_room'
);

eventSource.addEventListener('state_changed', (event) => {
  const data = JSON.parse(event.data);
  console.log('Entity changed:', data.entity_id, data.new_state);
});

See docs/SSE_API.md for complete SSE documentation.

Mode 3: Docker Standalone

# Pull image
docker pull ghcr.io/coffeerunhobby/mcp-ha-connect:latest

# Run in HTTP mode
docker run -d --name mcp-ha-connect \
  -e HA_URL=http://homeassistant.10.0.0.19.nip.io:8123 \
  -e HA_TOKEN=your_token \
  -e MCP_SERVER_USE_HTTP=true \
  -p 3000:3000 \
  ghcr.io/coffeerunhobby/mcp-ha-connect:latest

Mode 4: Docker Compose

version: '3.8'

services:
  mcp-ha-connect:
    image: ghcr.io/coffeerunhobby/mcp-ha-connect:latest
    container_name: mcp-ha-connect
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - HA_URL=http://homeassistant.10.0.0.19.nip.io:8123
      - HA_TOKEN=${HA_TOKEN}
      - MCP_SERVER_USE_HTTP=true
      - MCP_HTTP_BIND_ADDR=0.0.0.0
    networks:
      - home-automation

networks:
  home-automation:
    driver: bridge

Integration Examples

With Claude Desktop

Once configured, you can ask Claude:

"Show me all lights in my house"
"Turn on the kitchen lights to 50% brightness"
"Set the living room temperature to 72 degrees"
"Create an automation that turns off all lights at midnight"
"What automations are currently enabled?"
"Trigger the morning routine automation"
"Search for entities with 'bedroom' in their name"
"Get all climate entities"
"Analyze my sensors for any issues" (requires Ollama)
"Check the history of my thermostat"

With n8n Workflows

The server can be integrated with n8n for automated home monitoring. Pre-built workflows are available in the n8n/ directory:

ai-agent-safety-monitor - Critical safety monitoring every 5 minutes

Importing Workflows

Method 1: n8n UI

Open n8n: http://127.0.0.1:5678
Click Workflows → Import from File
Select JSON file from n8n-files/
Activate the workflow

Method 2: Docker CLI

# Copy workflow to n8n container
docker cp "n8n-files/AI Agent Safety Monitor - Updated.json" n8n:/files/workflow.json

# Import using n8n CLI
docker exec -it n8n n8n import:workflow --input=/files/workflow.json

# Verify import
docker exec -it n8n n8n list:workflow

With Web Applications

Use the HTTP transport with your MCP-compatible web client:

Start server in HTTP mode
Configure client to use http://localhost:3000/mcp
Set transport to Streamable HTTP (MCP 2025-03-26)
Enable CORS by adding your origin to MCP_HTTP_ALLOWED_ORIGINS

With Remote MCP Proxy (mcp-remote)

Connect a stdio-only client (Claude Desktop, LM Studio) to a remote HTTP MCP server using mcp-remote. On Windows, launch it through cmd /c and include -y so the first run never blocks on the npx install prompt:

{
  "mcpServers": {
    "homeassistant": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-remote",
        "https://your-server.example/mcp",
        "--header",
        "Authorization: Bearer <your-jwt-token>"
      ]
    }
  }
}

⚠️ Do not use ${VAR} placeholders in the --header value. A config like "Authorization: Bearer ${MCP_AUTH_TOKEN}" with a matching env block does not work on Windows: cmd /c only expands %VAR% (not ${VAR}), and mcp-remote does not substitute it either. The literal text ${MCP_AUTH_TOKEN} is sent as the token, the server replies 401, and mcp-remote then falls into a failing OAuth flow that surfaces as "Server disconnected". Inline the actual JWT instead. (On macOS/Linux you can instead let your shell expand the variable before the client launches.)

Network Configuration Notes

host.docker.internal - Use this to access services on your host machine from Docker
- Works on Windows and macOS by default
- On Linux, add --add-host=host.docker.internal:host-gateway to docker args
Direct IP - Use your machine's IP address (e.g., http://10.0.0.19:8123)
nip.io domains - Use wildcard DNS for easy local development (e.g., http://homeassistant.10.0.0.19.nip.io:8123)

Security Best Practices

Network Security

Network Segmentation: Run MCP server on private LAN only
Docker Networks: Use Docker networks for container isolation
VLAN: Consider VLAN for IoT devices
No Internet Exposure: Never expose MCP server directly to internet

Token & Configuration Security

Store .env securely (contains access token)
Never commit .env to version control
Set .env permissions: chmod 600 .env
Use HA_STRICT_SSL=true for HTTPS in production
Rotate access tokens periodically
Restrict MCP_HTTP_ALLOWED_ORIGINS (avoid wildcard *)
Bind to 127.0.0.1 for local-only access
Enable rate limiting in production (MCP_RATE_LIMIT_ENABLED=true)

MCP Client Configuration Security

⚠️ Important: Storing tokens directly in MCP client config files (Claude Desktop, LM Studio) exposes them to anyone with filesystem access. Consider:

Using .env files with restricted permissions for Docker/local deployments
Setting file permissions on config files (e.g., chmod 600)
Using environment variable substitution if supported by your client
Never committing config files with real tokens to version control

Server Instructions

The server provides MCP Server Instructions during initialization to help LLMs understand how to optimally use the available tools. Instructions are dynamically generated based on enabled plugins and include:

Entity Queries: Guidance on pagination, attribute inclusion, and using specialized tools like listPersons
Device Control: When to use specialized control tools vs generic callService
Automation Workflows: Best practices for creating and testing automations
Omada Operations: Site context requirements, client vs device distinction, rate limiting safety
Cross-Plugin Integration: How HA presence detection correlates with Omada network clients

Instructions follow MCP best practices: concise, actionable, and focused on tool relationships rather than repeating individual tool descriptions.

Troubleshooting

Claude Desktop / LM Studio Not Connecting

Check config file location - Verify you're editing the correct file
Restart the application - Close and reopen after config changes
Check logs - Look for error messages in the application logs
Test connection manually:

# Test npx
npx @coffeerunhobby/mcp-ha-connect

# Test Docker
docker run --rm -i \
  -e HA_URL=http://homeassistant.10.0.0.19.nip.io:8123 \
  -e HA_TOKEN=your_token \
  ghcr.io/coffeerunhobby/mcp-ha-connect:latest

mcp-remote Shows "Server disconnected" (401)

If /health returns 200 but the client shows "Server disconnected", the auth header is almost certainly malformed. Most common cause: a ${VAR} placeholder in the --header value that never got expanded (see the warning under With Remote MCP Proxy). Verify the endpoint accepts your token directly:

curl -i -X POST https://your-server.example/mcp \
  -H "Authorization: Bearer <your-jwt-token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"diag","version":"1.0"}}}'

A 200 with an initialize result means the server and token are fine — fix the client config (inline the literal token). A 401 means the token itself is wrong.

Docker `host.docker.internal` Not Working (Linux)

Add host gateway:

{
  "args": [
    "run",
    "--rm",
    "-i",
    "--add-host=host.docker.internal:host-gateway",
    "-e", "HA_URL=http://host.docker.internal:8123",
    ...
  ]
}

Home Assistant Connection Issues

Verify URL - Try accessing http://your-ha-url:8123/api/ in browser
Check token - Ensure it's a valid long-lived access token
Network access - Verify MCP server can reach Home Assistant
SSL issues - Try HA_STRICT_SSL=false for testing

AI Analysis Not Working

Verify Ollama is running - curl http://your-ollama-url:11434/api/tags
Check model is available - Ensure model is pulled: ollama pull llama2
Set AI_PROVIDER - Must be set to ollama (not none)

Development

Setup

# Clone repository
git clone https://github.com/coffeerunhobby/mcp-ha-connect.git
cd mcp-ha-connect

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Edit .env with your Home Assistant details
nano .env

# Build
npm run build

# Run
npm start

Available Scripts

npm run build      # Build TypeScript to dist/
npm run dev        # Run in development mode with watch
npm start          # Run built version
npm test           # Run tests
npm run lint       # Run ESLint
npm run format     # Format code with Prettier

License

MIT

Author

Coffee Run Hobby (github.com/coffeerunhobby)

Documentation

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.