Spook 👻 Your homie.
Enjoying Spook? 👻 A ⭐ on GitHub lets others know Spook is actually pretty great. Sponsoring Frenck keeps this ghost well fed. And his free bi-weekly newsletter keeps your inner ghost well fed.
About
Hi! I'm Spook 👻 and I'm a custom integration for use with Home Assistant. I will extend your Home Assistant instance with a huge set of scary powerful tools. 🛠️
Learn all about me in the extensive documentation
⚠️ Just to be very clear...
Spook is not affiliated with, endorsed, recommended, or supported by the Home Assistant project.
This custom integration is provided as-is, without any warranty.
Using Spook with AI agents
Let an AI agent manage your Home Assistant? Then it should know what Spook can do, without reading all of the documentation first. Spook ships an agent skill for that: its actions, triggers, conditions and repairs, in a form an agent can look things up in.
In Claude Code:
/plugin marketplace add frenck/spook /plugin install spook@spook
Other agents can use the skill folder directly:
plugins/spook/skills/spook.
Contributing
We've set up a separate document for our contribution guidelines.
Authors & contributors
The original setup of this repository is by Franck Nijhof.
Thanks to everyone who already contributed! ❤️
For a full list of all authors and contributors, check the contributor's page.
Translating Spook
Spook isn't very good at speaking different languages, but you can help!
As a matter of fact, Spooks translation files are CC0 licensed!
Translating can be done from your webbrowser, no programming knowledge is needed!
License
Copyright (c) 2023-2026 Franck Nijhof
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.