Made by @adidshaft ↗

Grok Bot is made by SpaceXSI.
Grok Gadgets is an independent project.

↗

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.

On this page

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

Start here

Path Next step
Try the probe Use a fixture without a home server
Check a home server Read the authentication limits first
See project status Separate the kit results from this integration

Install from PyPI

The package is on PyPI. Install it into a virtual environment with Python 3.11+. It is an alpha, so name the version or pass --pre:

python3 -m venv .venv
.venv/bin/python -m pip install --pre grok-gadgets-home-assistant
.venv/bin/ha-probe --version

Each GitHub release also has the wheel and SHA256SUMS; the PyPI files are the same build.

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

Quickstart

For contributors: use Python 3.11+, Git and uv. This fixture needs 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.

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

The owner verified the separate gateway route with OAuth from Mac and iPhone. That result does not verify Home Assistant authentication or home control.

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

Topic Guide
Set up a real home and remote route Setup recipe
Sources and open questions Feasibility record
What has been tested Verification
Run the checks uv run ruff check ., uv run ruff format --check ., uv run python -m unittest discover -s tests -v

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 Grok Gadgets community on X, 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 package is also on PyPI. 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.

Project discussion

Ask questions and share gadget ideas in hub Discussions. Use this repository's issue forms for defects.

Source: grok-gadgets-home-assistant/README.md