Grok Gadgets: Home Assistant

Check what Home Assistant's own MCP server would offer your Grok Bot. ha-probe lists its tools, resources and prompts without ever calling a tool or reading a resource. Experimental alpha: this Home Assistant integration has no verified real-home or Grok Bot result yet. See the project status. Independent project, not affiliated with SpaceXSI or Home Assistant.

Writing style: ASD-STE100-inspired English. Use short sentences, active verbs and one instruction per step. This is not certified compliance.

Quickstart

You need Python 3.11+, Git and uv. No home, account or token.

git clone https://github.com/adidshaft/grok-gadgets-home-assistant.git
cd grok-gadgets-home-assistant
uv sync --frozen
uv run ha-probe --fixture fixtures/assist.json

Expected result (other fixed flags omitted):

{
  "evidence": "fixture tested",
  "tool_count": 2,
  "resource_count": 1,
  "prompt_count": 1,
  "tool_calls_performed": 0,
  "resource_reads_performed": 0,
  "grok_verified": false,
  "hardware_verified": false
}

Next: prepare a Home Assistant test user.

Install with pip

The package is not on PyPI yet. Each GitHub release has a wheel and SHA256SUMS. Install the wheel into a virtual environment with Python 3.11+:

python3 -m venv .venv
.venv/bin/python -m pip install https://github.com/adidshaft/grok-gadgets-home-assistant/releases/download/v0.1.0-alpha.5/grok_gadgets_home_assistant-0.1.0a5-py3-none-any.whl
.venv/bin/ha-probe --help

On an Intel Mac, cryptography has no prebuilt wheel and needs a Rust toolchain to build.

Why a probe

Home Assistant already has its own MCP server, so Grok Gadgets does not wrap your home. The probe answers one question safely: what would a Grok Bot see if it connected? It lists tools, resources and prompts, and never calls a tool or reads a resource.

• Discovery only: redirects refused, responses capped at 4 MiB.
• Household names and descriptions are hidden in the output.
• Fixture output says "evidence": "fixture tested", never a real-home result.

Try it on your home

The setup guide walks through a test user with Control Home Assistant off, local discovery, token scope and cleanup. A Home Assistant token is a full user credential. Never paste it into chat or an issue, and revoke it after testing.

Grok Bot today

Connecting a Grok Bot needs a reachable HTTPS URL with compatible authentication; check the remote-route gate before you expose a home server. This package adds no home-control tools and no event-triggered Bot tasks. Issue HA-004 tracks native Bot compatibility; see also the hosting FAQ.

Learn more

New gadgets use the gateway and SDKs; this repository is part of Grok Gadgets.

Community

Share what your home exposes, ask questions and suggest ideas on r/GrokGadgets, under the project's Code of Conduct. Report bugs through the issue chooser. New here? Pick a good first issue and read CONTRIBUTING. Keep tokens and household names out of public posts. Contribute on the dev branch; main holds tagged stable releases (branches).

License and affiliation

Apache-2.0; see LICENSE and NOTICE. uv.lock pins the dependencies; the packages are not on PyPI yet. Grok Gadgets is an independent open-source project. It is not affiliated with, endorsed by or sponsored by SpaceXSI, which make Grok and Grok Bot, nor with Home Assistant. We reconstructed the pre-publication commit dates; see the history record.