Ghost MCP

An MCP (Model Context Protocol) server for interacting with Ghost CMS blogs through AI assistants.

Full documentation: https://workspace.github.io/ghost-mcp/

Quick Start

Local (stdio)

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "ghost": {
      "command": "npx",
      "args": ["-y", "@ryukimin/ghost-mcp"],
      "env": {
        "GHOST_URL": "https://your-blog.ghost.io",
        "GHOST_CONTENT_API_KEY": "your-content-api-key",
        "GHOST_ADMIN_API_KEY": "your-admin-id:your-admin-secret"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Remote (Docker)

docker compose up -d

See Remote Setup for the full guide.

Features

• Content API (read-only): Browse and read posts, pages, tags, and authors (8 tools)
• Admin API (full CRUD): Create, update, and delete posts, pages, tags, members, newsletters, tiers, offers, webhooks, and more (46 tools)
• Dual transport: stdio for local, Streamable HTTP for remote deployment
• OAuth 2.1: Secure per-user authentication for remote mode

Getting API Keys

1. In Ghost Admin, go to Settings > Integrations
2. Create a new Custom Integration
3. Copy the Content API Key for read-only access
4. Copy the Admin API Key for full access (id:secret format)

Development

npm install        # Install dependencies
npm run build      # Build TypeScript
npm start          # Run stdio server
npm run start:sse  # Run HTTP/SSE server
npm test           # Run tests
npm run lint       # Lint code

Documentation

• Getting Started
• Remote Setup
• Tools Reference
• Usage Examples
• NQL Filter Reference

License

ISC