homeassistant-mcp

  • Home Automation & IoT
TypeScript
MIT
69
7
-
security - not tested
A
license - permissive license (MIT)
-
quality - not tested

Access Home Assistant data and control devices (lights, switches, thermostats, etc).

  1. Tools
  2. Prompts
  3. Resources
  4. Server Configuration
  5. README.md

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription

No tools

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TOKENYesYour personal access token for Home Assistant. See https://community.home-assistant.io/t/how-to-get-long-lived-access-token/162159 for a guide.
BASE_URLYesThe base URL for your Home Assistant instance.
README.md

A Model Context Protocol Server for Home Assistant

The server uses the MCP protocol to share access to a local Home Assistant instance with an LLM application.

More about MCP here: https://modelcontextprotocol.io/introduction

More about Home Assistant here: https://www.home-assistant.io

Usage

First build the server

yarn build

Then configure your application (like Claude Desktop) to use it.

{ "mcpServers": { "homeassistant": { "command": "node", "args": [ "/Users/tevonsb/Desktop/mcp/dist/index.js" ], "env": { "TOKEN": <home_assistant_token>, "BASE_URL": <base_url_for_home_assistant> } } } }

You'll need a personal access token from home assistant.

Get one using this guide: https://community.home-assistant.io/t/how-to-get-long-lived-access-token/162159

In Progress

  • Access to entities
  • Access to Floors
  • Access to Areas
  • Control for entities
    • Lights
    • Thermostats
    • Covers
  • Testing / writing custom prompts
  • Testing using resources for high-level context
  • Test varying tool organization

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues with dependencies of the server.
  • Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file:

Alternative MCP servers

  • -
    security
    A
    license
    -
    quality
    Smart Device Control šŸŽ® šŸ’” Lights: Brightness, color, RGB šŸŒ”ļø Climate: Temperature, HVAC, humidity šŸšŖ Covers: Position and tilt šŸ”Œ Switches: On/off šŸšØ Sensors: State monitoring Intelligent Organization šŸ  Grouping with context awareness. Robust Architecture šŸ› ļø Error handling, state validation ...
    Apache-2.0
  • -
    security
    F
    license
    -
    quality
    Enables semantic search and RAG (Retrieval Augmented Generation) over your Apple Notes.
    • Apple
  • -
    security
    A
    license
    -
    quality
    Allows the AI to read from your local Apple Notes database (macOS only)
    MIT
    • Apple