AI agents for Ghost

Find posts

Lists posts, newest published first, filtered by status (draft, scheduled, published, sent) or an NQL filter such as tag:news, featured:true, title:~'launch' or published_at:>'2026-01-01'.

Get a post

Reads one post by its ID with its content as HTML: id, title, slug, status, url, html, custom_excerpt, feature_image, featured, visibility, published_at, updated_at.

Find pages

Lists static pages, by title, optionally with an NQL filter such as status:draft or title:~'about'.

List tags

Lists the site's tags by name, with how many posts carry each.

Find members

Lists members (subscribers), newest first, with an NQL filter such as email:'jamie@example.com', name:~'jam', status:paid (free, paid, comped), label:vip, subscribed:true or created_at:>'2026-01-01'.

Get a member

Reads one member by ID: email, name, note, status, comped, subscribed, labels, newsletters, subscriptions.

List newsletters

Lists the site's newsletters (active ones unless asked for all).

List tiers

Lists the site's membership tiers (free and paid).

Write a post

Creates a post from a title and HTML, as a draft by default, or published at once (published), or scheduled (scheduled with a future published_at).

Update, publish or schedule a post

Changes a post by its ID: title, HTML content (replaces it), status (publish a draft, schedule it with published_at, or unpublish to draft), tags.

Delete a postDeletes data

Deletes a post by its ID for good (Ghost has no trash).

Add a member

Adds a free member by email, with an optional name, internal note, labels.

Update a member

Changes a member by ID: name, email, note, labels (by name; the list replaces the old one) or newsletters (by ID; the list replaces the old one, so an empty list unsubscribes from all).