BlogFactory

Ghost CMS MCP server

Write with your AI. Publish safely to Ghost.

Ghost Publisher is an unofficial, local-first MCP server for Ghost posts and Pages, publication diagnostics, scheduling, images, separately approved publishing, deploy hooks, and bounded live checks.

Install freeView on GitHub

MIT · Local stdio · Permission profiles · No delete tools

Ghost Publisher MCP
Local-first

One-command setup

Connect without exposing the key to a hosted tool.

The installer prompts privately for a Ghost Admin API key, checks the connection without writing, and asks before changing supported client configuration.

npx -y ghost-publisher-mcp@latest setup \
  --url https://your-ghost.example.com

Safer first connection: select the read-only permission profile, then grant only the workflow you need.

Why use it

A narrow Ghost surface with explicit write controls.

Local credentials

The Ghost Admin key stays in the local MCP client configuration instead of a Ghost Publisher-hosted service.

Bounded Ghost scope

Work with posts, Pages, images, schedules, diagnostics, deploy hooks, and live checks—not the full Ghost Admin API.

Preview before change

Revision checks, signed previews, exact scopes, and caller-attested confirmation guard approved edits and transitions.

Verify the result

Publish an approved batch, trigger one configured deployment, and check the rendered public result as separate bounded steps.

Workflow

Start read-only. Widen authority deliberately.

  1. 01ConnectVerify the Ghost site and begin with the read-only profile.
  2. 02InspectRead exact posts or Pages, audit content, and check publication health.
  3. 03ApprovePreview exact changes or a schedule and confirm the named transition.
  4. 04VerifyApply once, inspect the receipt, deploy once when configured, and check live output.

Permission profiles

Register only the capabilities the operator intends to use.

read-only
Connection checks, content reads, audits, previews, health checks, and schedule planning without write tools.
draft-editor
Adds draft creation, approved change-set application, and validated local image uploads.
scheduler
Adds guarded schedule and unschedule operations using exact revisions and a signed plan.
publisher
Adds explicit publish, unpublish, deployment, and published-metadata workflows. It still does not add deletion or general administration.

Install free

Run setup in a private terminal.

You need Node.js 22 or newer, a Ghost site, and a Ghost custom integration Admin API key. The interactive installer detects Codex, Cursor, and Claude Desktop configuration targets.

Open the repository

Private terminal
No write on check
npx -y ghost-publisher-mcp@latest setup \
  --url https://your-ghost.example.com
# Preview configuration without changing it
npx -y ghost-publisher-mcp@latest setup \
  --url https://your-ghost.example.com \
  --permission read-only \
  --dry-run

Never paste the Admin key into a chat, issue, command argument, commit, screenshot, or hosted form.

Verified proof

A documented production workflow, with its limits attached.

The Ortak Alan case study records the maintainer-operated setup, exact versions, read-only verification, and operational limits. It does not claim that this MCP alone caused search growth.

Read the case study

  • ✓Draft creation is always draft-only.
  • ✓Publishing, scheduling, applying changes, unpublishing, and deployment require separate confirmation.
  • ✓Write batches preflight every target before the first mutation.
  • ✓No delete, members, newsletters, themes, arbitrary API calls, remote transport, or built-in AI billing.

Questions

Know the publishing boundary.

Is Ghost Publisher an official Ghost product?+

No. It is an independent open-source project maintained by BlogFactoryHQ and is not affiliated with or endorsed by the Ghost Foundation.

Can it publish Ghost posts?+

Yes, when the publisher profile is enabled and the caller separately confirms the exact transition. Draft creation itself can never publish.

Can it delete content or administer Ghost?+

No. Deletion, members, newsletters, themes, users, roles, arbitrary queries, and general site administration are outside the tool surface.

Where is the Ghost Admin key stored?+

It stays in the selected MCP client's local user configuration or process environment. Ghost Publisher does not operate a hosted credential service.

Does it support Ghost Pages and headless sites?+

Yes. It has separate bounded Page workflows plus optional deploy hooks and public URL templates for headless or static delivery checks.

Which MCP clients can use it?+

The installer supports Codex, Cursor, and Claude Desktop configuration targets. The server uses local stdio and can be configured manually in compatible MCP clients.

Does it include an AI model or model credits?+

No. Your AI client writes or researches with its own capabilities. Ghost Publisher performs the Ghost-specific actions and stores no AI billing state.

Connect to Ghost with the smallest permission profile.

Run the installer privately, verify the site without writing, and grant only the workflow you are ready to approve.

Install free