Ghost MCP

A Model Context Protocol server that gives Claude, Gemini, and any other MCP-compatible AI full access to your Ghost CMS via the Ghost Admin API.

Documentation languages: English · Français · Español

Features

• 47 tools across 10 resource types — posts, members, users, tags, tiers, offers, newsletters, invites, roles, and webhooks
• 7 MCP resources — fetch any Ghost entity by URI (e.g. post://abc123)
• 2 built-in prompts — summarize-post and content-audit
• Typed error handling — Ghost API errors are caught and surfaced as clean messages, not raw stack traces
• Full tool descriptions — every tool includes a plain-English description and per-parameter hints so the LLM understands exactly what to pass
• Zero any types — proper TypeScript interfaces throughout

Quick start

1. Prerequisites

• Node.js >= 18
• A Ghost site with Admin API access (Ghost Pro or self-hosted)

2. Get your Ghost credentials

1. In your Ghost Admin dashboard, go to Settings → Integrations
2. Click Add custom integration, give it a name (e.g. "MCP")
3. Copy the Admin API Key — it looks like id:secret

3. Pick your AI client

No cloning or building required. Every integration below uses npx ghost-mcp to run the server on demand.

Client integrations

Claude Desktop

The recommended integration. MCP is a native feature of Claude Desktop.

Config file location:

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

{
  "mcpServers": {
    "ghost": {
      "command": "npx",
      "args": ["-y", "ghost-mcp"],
      "env": {
        "GHOST_API_URL": "https://yourblog.com",
        "GHOST_ADMIN_API_KEY": "your_id:your_secret",
        "GHOST_API_VERSION": "v5.0"
      }
    }
  }
}

Restart Claude Desktop. A hammer icon will appear in the chat input indicating all 47 tools are available.

Claude Code (CLI)

Run this once in your terminal — Claude Code will persist the server across sessions:

claude mcp add ghost \
  --command npx \
  --args "-y,ghost-mcp" \
  -e GHOST_API_URL=https://yourblog.com \
  -e GHOST_ADMIN_API_KEY=your_id:your_secret

Or add it manually to .claude/mcp.json in your project using the same JSON shape as Claude Desktop above.

Gemini CLI

Google's Gemini CLI supports MCP servers natively.

Config file: ~/.gemini/settings.json

{
  "mcpServers": {
    "ghost": {
      "command": "npx",
      "args": ["-y", "ghost-mcp"],
      "env": {
        "GHOST_API_URL": "https://yourblog.com",
        "GHOST_ADMIN_API_KEY": "your_id:your_secret",
        "GHOST_API_VERSION": "v5.0"
      }
    }
  }
}

Start a session with gemini and the Ghost tools will be available automatically.

ChatGPT

ChatGPT does not support MCP. OpenAI uses a separate plugin/GPT Actions system based on OpenAPI specs. There is no direct integration path — you would need to wrap this server in an HTTP REST layer to use it with ChatGPT.

Other MCP-compatible clients

Any client that speaks the MCP stdio transport can run this server. The command is always:

npx -y ghost-mcp

with GHOST_API_URL and GHOST_ADMIN_API_KEY set in the environment.

Tools reference

Posts (5 tools)

| Tool | Description | |---|---| | posts_browse | List posts with filters, pagination, and sorting | | posts_read | Fetch a single post by ID or slug | | posts_add | Create a new post (draft or published) | | posts_edit | Update an existing post | | posts_delete | Permanently delete a post |

Members (5 tools)

| Tool | Description | |---|---| | members_browse | List members with filters | | members_read | Fetch a single member by ID or email | | members_add | Add a new member | | members_edit | Update a member's details or subscriptions | | members_delete | Remove a member |

Users (4 tools)

| Tool | Description | |---|---| | users_browse | List staff users | | users_read | Fetch a single user by ID, email, or slug | | users_edit | Update a user's profile | | users_delete | Delete a staff user |

Tags (5 tools)

| Tool | Description | |---|---| | tags_browse | List all tags | | tags_read | Fetch a single tag by ID or slug | | tags_add | Create a new tag | | tags_edit | Update a tag | | tags_delete | Delete a tag |

Tiers (5 tools)

| Tool | Description | |---|---| | tiers_browse | List membership tiers | | tiers_read | Fetch a single tier | | tiers_add | Create a paid tier | | tiers_edit | Update a tier | | tiers_delete | Delete a tier |

Offers (5 tools)

| Tool | Description | |---|---| | offers_browse | List promotional offers | | offers_read | Fetch an offer by ID or code | | offers_add | Create a discount or trial offer | | offers_edit | Update an offer's display text | | offers_delete | Delete an offer |

Newsletters (5 tools)

| Tool | Description | |---|---| | newsletters_browse | List newsletters | | newsletters_read | Fetch a single newsletter | | newsletters_add | Create a new newsletter | | newsletters_edit | Update newsletter settings | | newsletters_delete | Delete a newsletter |

Invites (3 tools)

| Tool | Description | |---|---| | invites_browse | List pending staff invitations | | invites_add | Send a staff invitation | | invites_delete | Cancel an invitation |

Roles (2 tools)

| Tool | Description | |---|---| | roles_browse | List available roles | | roles_read | Fetch a single role by ID or name |

Webhooks (5 tools)

| Tool | Description | |---|---| | webhooks_browse | List configured webhooks | | webhooks_read | Fetch a single webhook | | webhooks_add | Create a new webhook | | webhooks_edit | Update a webhook | | webhooks_delete | Delete a webhook |

MCP Resources

Access Ghost entities directly by URI:

| URI pattern | Returns | |---|---| | post://{post_id} | Full post object including tags and authors | | user://{user_id} | Staff user with roles | | member://{member_id} | Member with labels and subscriptions | | tier://{tier_id} | Tier with pricing details | | offer://{offer_id} | Promotional offer details | | newsletter://{newsletter_id} | Newsletter configuration | | blog://info | Site settings and metadata |

Built-in prompts

summarize-post

Fetches a Ghost post and asks the LLM to write a concise 2-3 sentence summary.

Parameter: postId — the Ghost post ID

content-audit

Fetches recent posts and asks the LLM to audit them for title quality, tagging consistency, publishing cadence, author diversity, and content strategy.

Parameters:

• limit — number of posts to include (default: 10)
• status — post status to filter by: published | draft | scheduled (default: published)

Environment variables

| Variable | Required | Default | Description | |---|---|---|---| | GHOST_API_URL | Yes | — | Your Ghost site URL, e.g. https://yourblog.com | | GHOST_ADMIN_API_KEY | Yes | — | Admin API key in id:secret format | | GHOST_API_VERSION | No | v5.0 | Ghost API version |

See docs/en/configuration.md for full details.

Documentation

| Document | Contents | |---|---| | docs/en/configuration.md | Environment variables, Claude Desktop setup, troubleshooting | | docs/en/tools.md | Complete tool reference with all parameters | | docs/en/resources.md | MCP resource URI reference | | docs/en/development.md | Build, test, and extend the server |

License

MIT