Skip to content

Website guide

Can AI Edit or Publish to Your Ghost Site?

Yes, through Ghost's Admin API with a scoped key, not through a chat window. Ghost's built-in AI feature only helps AI search tools find your content.

Figment editorial teamPublished Updated

Yes, through Ghost's Admin API, not through a chat conversation. A normal ChatGPT or Claude chat has no access to your Ghost site. Ghost's own built-in AI feature is about being found by AI tools, not editing your site with one. For an agent to draft, edit or publish content, it needs a credential: either a Custom Integration's Admin API key, which is limited to a fixed set of endpoints, or a staff access token, which inherits whatever a specific staff user's role can do. The one you hand an agent decides how much of your site it can reach.

What does Ghost's own built-in AI do?

It helps AI search tools find your content. Ghost's built-in AI feature, shipped July 16, 2026, provides GEO tools that generate the files AI systems look for and serve Markdown versions of your public content. You turn it on in Settings → Meta data (Ghost Changelog, "Optimize your site for AI search", July 16, 2026). Once enabled, Ghost publishes an llms.txt file at your domain's root and serves a Markdown version of any post when you append .md to its URL, the same mechanism that renders ghost.org/changelog/geo.md. Only public content is included: "Members-only and paid posts are listed with their public title and excerpt, but their protected content is not," and private sites do not serve these files at all (same source).

This is off by default for existing sites: "this feature is off by default for existing sites... there's nothing you need to do; it will remain switched off" unless you turn it on. Ghost(Pro) users get it immediately. "If you're a developer, self-hosting Ghost, you'll need to update to the latest version to get access to everything that's new" (same source). Ghost does not publish a separate in-editor writing assistant or design-generation AI as of this check.

Can an outside AI agent edit my existing Ghost site?

Yes, through the Admin API. There is no official Ghost MCP server, so a scoped API key is the real route. Ghost's developer docs describe two ways an agent authenticates: integration tokens, meant for integrations that handle common workflows such as publishing content, and staff access tokens, meant for people who act as themselves without sharing a password (Ghost Developer Docs, Admin API).

The two routes reach different amounts of the site:

  • Custom Integration (Admin API key). Create it from Settings → Integrations → Add custom integration in Ghost Admin: "Admin API keys can be obtained by creating a new Custom Integration under the Integrations screen in Ghost Admin" (same source). This is the scoped route: "Integrations have a restricted set of fixed permissions allowing access to certain endpoints e.g. GET /users/ or POST /posts/". It is a fixed, documented set, not a full user's permissions.
  • Staff access token. Found on a specific staff user's own profile page. "User permissions (whether using staff tokens or user authentication) are dependent entirely on their role... Authenticating as a user with the Owner or Admin role will give access to the full set of API endpoints." Ghost's docs add one hard limit that applies even at the top role: "Staff tokens cannot transfer ownership or delete all content" (same source).

Ghost does not publish an MCP server. Community-built MCP servers exist that wrap the Admin API for MCP clients like Claude, but they are third-party tools that Ghost does not document or maintain. Treat them like any other unofficial integration and review what scope of key you hand them.

What can an agent publish, and what can't it?

It depends on the staff role, so give the agent the lowest role that can do its job, not your Owner login. Ghost's help center lists four staff roles with a specific permission breakdown (Ghost, "What permissions do staff users have?"):

RoleCreate postsPublish postsEdit others' postsSite settings
ContributorYesNo (drafts only)NoNo
AuthorYesYes, own postsNoNo
EditorYesYesYesNo
AdministratorYesYesYesYes

A Contributor is the safest role for an agent that drafts content for you to review and publish yourself. It can create and edit its own drafts but cannot publish them or touch anyone else's content. An Author is the lowest role that can publish on its own, appropriate only once you trust the agent's output without a human gate. Neither role can change site settings, themes or other users, regardless of what credential reaches it.

Does self-hosted vs Ghost(Pro) change what an agent can do?

No. The Admin API and staff roles work the same either way. Ghost's hosting guide states the product is identical across both: "Product features: Identical, Identical" between Ghost(Pro) and self-hosting (Ghost Developer Docs, "Hosting Ghost"). What differs is who manages the infrastructure around it: Ghost(Pro) bundles services such as email delivery and full site backups, while a self-hosted install sources those separately (same source). For an agent workflow, a self-hosted install has to be updated manually to receive new features like GEO, while Ghost(Pro) gets them automatically.

How do I set this up safely?

  1. Decide the job. Drafting new posts from source material is different from bulk-editing tags across hundreds of existing posts. The second has a much bigger blast radius.
  2. Create a Custom Integration, not a personal staff token, when the job is narrow. Settings → Integrations → Add custom integration gives you an Admin API key scoped to the fixed set of endpoints Ghost documents, independent of any human user's account.
  3. Use a Contributor-role staff account instead when the agent needs to work inside the normal editor UI. It can only draft, so nothing is published without your review.
  4. Regenerate the key when the task is done. "You can regenerate the Admin API key any time, but any scripts or applications using it will need to be updated." There is no separate revoke step, so regenerating invalidates the old key immediately.
  5. Check the live post. Preview before publishing, then open the public URL and confirm formatting, images and any newsletter send behaved as expected.
  6. Never give ChatGPT or Claude your Ghost password, a security code or a browser session. Remove member names and emails before you paste content into a chat.

What is the recovery path if something goes wrong?

Ghost's own export is the backup. From Settings → Advanced → Import/Export, exporting produces "a single JSON file" containing "All Settings, Staff users, Posts, Pages, Tags, Members" (Ghost, "Exporting content and data"). Members also export separately as CSV with fields including subscription status and Stripe customer ID, and theme files download as a zip from Design & branding settings. Export the JSON file before letting an agent run a bulk operation across your content. It is the only way back if a scoped key does more than you intended within its permitted endpoints.

For the builder-by-builder view of what is exportable, our export capability matrix covers Ghost alongside 15 other platforms. For what an AI agent can and cannot do once it has access to any site, see how ChatGPT, Claude, Codex or Cursor can edit an existing website. For the role-and-token question platform by platform, see how to give an AI agent access to your website without handing over your login.