Advertise
MCP.so
Sign In

Home Assistant MCP Server

@oleander

Repository

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

oleander

About Home Assistant MCP Server

home-assistant-mcp-server

Home Assistant MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "home-assistant-mcp-server": {
      "command": "bun",
      "args": [
        "run",
        "build"
      ]
    }
  }
}

Home Assistant MCP Server tools

10

Query entity states

List lights

Control a light

Call Home Assistant services

Retrieve historical entity data

List available services

Get Home Assistant configuration

List available domains

Get Home Assistant error log

Get all devices in Home Assistant

Overview

What is Home Assistant MCP Server?

Home Assistant MCP Server is a Model Context Protocol (MCP) server for integrating with Home Assistant, enabling LLMs to control and query your smart home via natural language. It works with any MCP‑compatible client, such as Claude Desktop.

How to use Home Assistant MCP Server?

Install globally with bun install -g home-assistant-mcp-server or build from source. Configure a .env file with HASS_URL and HASS_TOKEN (or HASS_MOCK=true for demo). Run as a standalone server with home-assistant-mcp-server (default HTTP/SSE) or add the --stdio flag for stdio transport. For Claude Desktop, edit claude_desktop_config.json to include the server command and environment variables.

Key features of Home Assistant MCP Server

  • Query and control Home Assistant entities via natural language
  • Works with any MCP‑compatible client
  • Provides tools for state management, service calls, and history
  • Secure authentication using long‑lived access tokens
  • Multiple transport options: stdio and SSE/HTTP
  • Demo mode with mock data for testing without Home Assistant

Use cases of Home Assistant MCP Server

  • Control lights and smart devices via natural language from an LLM
  • Query entity states and history for automation and insights
  • Test integrations using demo mode when no Home Assistant is available
  • Run locally via stdio or remotely over HTTP/SSE
  • Integrate with Claude Desktop for conversational smart home control

Frequently asked questions

1

How do I enable demo mode for testing without Home Assistant?

Set `HASS_MOCK=true` in the `.env` file or pass the `--mock` flag when starting the server.

2

What are the authentication requirements?

You need a Home Assistant long‑lived access token. Generate one from your Home Assistant profile and set it as the `HASS_TOKEN` environment variable.

Comments

More AI & Agents MCP servers

HeyLead: LinkedIn Outreach & Lead Generation MCP Server

D4umak

HeyLead: AI agent for LinkedIn outreach. Finds the right people, writes in your voice, follows up and handles replies, from Claude Code, Cursor, any MCP client or a web dashboard.

9

Gemina

Gemina Tech Ltd.

Extract, search and tag any document — invoices, receipts, contracts, forms, or your own templates. 13 tools, one sign-in (OAuth 2.1) or API key, free FileTag tier, data residency in the EU, US, Israel or Asia.

OpenZiti / LLM-Gateway

openziti

NetFoundry LLM Gateway is an OpenAI-compatible API proxy that routes requests across multiple LLM providers using zero-trust networking. Zero trust LLM gateway. OpenAI-compatible proxy with semantic routing and load bala

93

Sphere Marketplace

dtajitdinov-aris

Sphere is an exchange where AI agents list services and post requests for other agents. Registration is one request, free, with no human approval. The first order is free: sphere_receipt_trial, one per agent per 24 hours

F

Factanker

FACTANKER serves 1.18B+ evidence-backed facts about US companies, banks, nonprofits and federal spending, sourced from SEC EDGAR, FFIEC call reports, IRS 990 filings and USAspending. Every value carries its evidence: fil

Advertise