Ghost smart home integration, free and open source

Members, posts and newsletters of your Ghost blog in Gladys, with scenes on new members and posts.
Ghost is an open source (MIT) publishing platform for blogs and newsletters, self-hosted or on Ghost(Pro). This integration brings the figures of your blog into Gladys: its members (free, paid, new ones), its posts (published, drafts, scheduled, the latest one) and the subscribers of each newsletter. Scenes can react to a new member or to a new post, a dashboard widget shows the blog at a glance, and a scene action puts its figures in a message.
Tested against a real self-hosted Ghost 6.77 (Docker, SQLite); not yet on Ghost(Pro), and paid members could not be tested (no Stripe account): feedback welcome on the issues.
What you need
- Gladys Assistant 5.1.0 or later.
- A Ghost blog, version 5 or 6, self-hosted or on Ghost(Pro), reachable from the Gladys machine.
- The Admin API key of a custom integration (an owner or administrator of the blog creates it). The key reads everything on the blog: the integration only reads, never writes.
At each refresh the integration sends nine requests to Ghost, whatever the size of the blog (the counts come from the totals of the API, one member or post per request). Ghost publishes no quota for the Admin API; every 5 minutes by default stays far below what any blog handles.
Getting started
1. Create a custom integration in Ghost
- In the Ghost admin, open Settings → Integrations (under "Advanced").
- Add custom integration, name it "Gladys", then Create.
- Copy the Admin API key (it looks like
6a1b…:9f3c…, an id, a colon and a long secret). Not the Content API key: it cannot read the members.
2. Configure the integration
- In Gladys, Integrations → Ghost → Configuration.
- Blog address: the address of your site, for example
https://blog.example.org(an address copied from the admin,…/ghost/#/dashboard, works too). A local Ghost:http://192.168.1.10:2368. If the admin of your blog has its own domain, use that one. - Admin API key: paste the key.
- Refresh interval: 1, 5 (default), 15 or 30 minutes. It is also the delay of the scenes.
- Language of the names: the language of the feature names, the dates and the scene sentences (French by default).
- Save, then Test the connection: it answers with the version of Ghost, the members and the published posts.
3. Add the devices
Open the Discover tab: the blog, its members, its posts and each active newsletter are proposed as devices. Add the ones you want.
The devices
The blog (named after its title):
- Online: 1 when Ghost answers, 0 otherwise.
- Ghost version: for example
6.77.
"Members":
- Members, Free members, Paid members (complimentary plans included).
- New members (24 h) and New members (7 days): members who joined in the last 24 hours, the last 7 days.
"Posts":
- Published posts, Drafts, Scheduled posts.
- Latest post: the title of the newest published post, and Latest post date: its date, in the time zone of Gladys.
"Newsletter …", one per active newsletter: Subscribers.
The values are sent to Gladys only when they change (and every 12 hours at least), with history for the counters.
Dashboard
The Ghost blog widget shows four tiles (members, paid, new in 7 days, posts), the latest post with its date, and a Refresh button that reads Ghost again at once. The latest post and the button can be hidden in the widget settings. When Ghost does not answer, the widget says why under the last figures read.
Scenes
Triggers
- New member: someone joins the blog. Optionally restrict it to a plan (free, paid, complimentary). The scene can use the name and email of the member, their plan and the name of the blog.
- Post published: a post is published, right away or at its scheduled time. The scene can use the title and the address of the post.
Both are seen at the next reading of Ghost (the refresh interval). The first reading only records what exists; what came while the integration was stopped is announced at its restart.
Actions
- Read the figures of the blog: reads members and posts again (if the last reading is older than 15 seconds) and gives them to the next actions, with a ready-made sentence: "My blog: 132 member(s), 12 paid, 3 new in 24 h, 9 in 7 days, latest post "Hello" on 15/11/2026, 21:22."
Scene ideas
- A notification "New member: {{name}}" on New member, only for paid ones.
- Every Monday at 8:00, Read the figures of the blog then send the sentence to your phone.
- When Online stays at 0 for 10 minutes, a notification: the blog is down.
Troubleshooting
- "Ghost does not answer": check the address and that the Gladys machine can reach it.
- "Admin API key refused": the custom integration was deleted or its key regenerated: copy the key again.
- "This is not an Admin API key": you copied the Content API key.
- "no Ghost blog at this address": check the address; a Ghost in a
sub-directory (
https://example.org/blog) needs it. - "the address redirects elsewhere": enter the address of the Ghost admin (the one of your browser when you log in to Ghost).
- "certificate refused": a self-signed certificate is not accepted: use
the
http://address on your network. - The logs of the integration (Integrations → Ghost) say more; nothing is written there during a normal reading cycle.
Limits
- Read-only: the integration does not change anything in Ghost.
- One blog per integration. An archived newsletter keeps its device and its last value: delete it in Gladys.
- "Paid members" is every member minus the free ones: paid and complimentary plans together.
- A post published with a date in the past (back-dated) does not fire Post published. At most 20 new members and 10 new posts are announced per reading.
- Not tested on Ghost(Pro) nor with Stripe yet, and not affiliated with the Ghost Foundation.
Configuration settings
These are the settings Ghost asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Your Ghost blog | section | No | In Ghost: Settings → Integrations → Add custom integration, then copy its Admin API key. Fill in the address of the blog, then add the devices from the Discover tab. |
| Blog address | string | Yes | The address of your Ghost site (or of its admin, if separate). |
| Admin API key | secret | Yes | The Admin API key of the custom integration (id:secret), not the Content API key. |
| Refresh interval | select | No | How often Ghost is read (9 requests each time). Also the delay of the scenes. |
| Language of the names | select | No | Language of the feature names, dates and scene sentences. |
How to install Ghost in Gladys
- In Gladys, open Integrations: Ghost appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/guim31/gladys-ghost:1.0.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/guim31/gladys-ghost.
Ghost requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Ghost is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by guim31, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation