homeassistant-aiOfficial·8 Agent Skills Included

ha-mcp

Let AI assistants control your Home Assistant smart home

Connects AI assistants to Home Assistant so they can control devices, query states, run services, and manage automations through natural language. Removes the need for manual API calls, token juggling, and custom scripting when linking an AI client to a smart home. Ships 88+ ready tools with flexible install options including HACS component, add-on, Docker, and PyPI.

4,592|202

↗

npx skills add homeassistant-ai/ha-mcp --all -g -y

Available:

Tells the AI agent how this repository is structured, which slash-command skills to invoke for issue analysis, PR resolution, and testing, and what security and workflow rules to follow when working on the codebase.

All Skills in This Repository (8)

Pure Emerald Level Indicators

📦 In Repo

homeassistant-ai

bat-story-eval

Compare MCP tool behavior across versions using diff-based story evaluation.

my-pr-checker

Automate GitHub PR triage by inspecting CI status, reviews, and threads.

issue-analysis

Analyze GitHub issues and generate structured implementation plans.

issue-to-pr-resolver

Automate GitHub issue resolution into a merge-ready pull request.

bat-adhoc

Run BAT tests via tests/uat/run_uat.py to validate MCP tools from an AI agent's perspective.

contrib-pr-review

Evaluate external pull requests for safety, quality, and readiness.

wt

Create a git worktree under worktree/<branch> and update submodules.

contributors-update

Finds merged PR authors missing from README and updates the contributors list after approval.

Official

Intermediate

Frequently Asked Questions

FAQPage Schema

How to install ha-mcp?▼

Run `npx skills add homeassistant-ai/ha-mcp --all -g -y` in your terminal to install all skills in this suite globally.

What can ha-mcp do with my smart home?▼

It gives your AI assistant 88+ tools to control lights and devices, read sensor states, create and edit automations, and manage your entire Home Assistant setup through plain-English requests.

Which AI clients work with ha-mcp?▼

It works with Claude Desktop, Claude.ai, ChatGPT, Cursor, and any other MCP-compatible client, either locally or remotely via webhook.

Do I need coding skills to use ha-mcp?▼

No. Install it through HACS or the Home Assistant add-on store, copy the connect URL into your AI client, and start asking for things in plain English.

Is ha-mcp secure for remote access?▼

Yes. It supports secret URLs, Home Assistant account sign-in, and OIDC providers like Authentik or Auth0 to gate remote access safely.