Skip to content
MCP server

Ghost Publisher

Local-first MCP server for safe Ghost authoring, diagnostics, scheduling, and publishing.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.10.1
Listing updated
4 days ago

About Ghost Publisher

Ghost Publisher is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add ghost-publisher --env GHOST_URL='<GHOST_URL>' --env GHOST_ADMIN_API_KEY='<GHOST_ADMIN_API_KEY>' --env GHOST_DEPLOY_HOOK_URL='<GHOST_DEPLOY_HOOK_URL>' -- npx -y ghost-publisher-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ghost-publisher": {
      "command": "npx",
      "args": [
        "-y",
        "ghost-publisher-mcp"
      ],
      "env": {
        "GHOST_URL": "<GHOST_URL>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>",
        "GHOST_DEPLOY_HOOK_URL": "<GHOST_DEPLOY_HOOK_URL>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ghost-publisher": {
      "command": "npx",
      "args": [
        "-y",
        "ghost-publisher-mcp"
      ],
      "env": {
        "GHOST_URL": "<GHOST_URL>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>",
        "GHOST_DEPLOY_HOOK_URL": "<GHOST_DEPLOY_HOOK_URL>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ghost-publisher": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ghost-publisher-mcp"
      ],
      "env": {
        "GHOST_URL": "<GHOST_URL>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>",
        "GHOST_DEPLOY_HOOK_URL": "<GHOST_DEPLOY_HOOK_URL>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ghost-publisher": {
      "command": "npx",
      "args": [
        "-y",
        "ghost-publisher-mcp"
      ],
      "env": {
        "GHOST_URL": "<GHOST_URL>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>",
        "GHOST_DEPLOY_HOOK_URL": "<GHOST_DEPLOY_HOOK_URL>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ghost-publisher": {
      "command": "npx",
      "args": [
        "-y",
        "ghost-publisher-mcp"
      ],
      "env": {
        "GHOST_URL": "<GHOST_URL>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>",
        "GHOST_DEPLOY_HOOK_URL": "<GHOST_DEPLOY_HOOK_URL>"
      }
    }
  }
}

Configuration

  • GHOST_URLURL of the Ghost site.Required
  • GHOST_ADMIN_API_KEYAdmin API key from a Ghost custom integration.Required
  • GHOST_API_VERSIONGhost Admin API compatibility version; defaults to v5.0.
  • GHOST_PERMISSION_PROFILEPermission profile: read-only, draft-editor, scheduler, or publisher. Defaults to publisher.
  • GHOST_READ_ONLYLegacy alias for the read-only profile. Do not combine with GHOST_PERMISSION_PROFILE.
  • GHOST_UPLOAD_ROOTSAllowed absolute directories for local image uploads.
  • GHOST_DEPLOY_HOOK_URLOptional deployment hook called once after a completely successful publish or unpublish batch.
  • GHOST_PUBLIC_POST_URL_TEMPLATEOptional public post URL containing {slug} for live checks.
  • GHOST_PUBLIC_PAGE_URL_TEMPLATEOptional public page URL containing {slug} for headless live checks.

Pricing

Open source

Ghost Publisher FAQ

Is Ghost Publisher free?

Yes. Ghost Publisher is open source, so you can use and self-host it for free.

How do I add Ghost Publisher to Claude Code?

Run this command in your terminal: claude mcp add ghost-publisher --env GHOST_URL='<GHOST_URL>' --env GHOST_ADMIN_API_KEY='<GHOST_ADMIN_API_KEY>' --env GHOST_DEPLOY_HOOK_URL='<GHOST_DEPLOY_HOOK_URL>' -- npx -y ghost-publisher-mcp