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.