home / mcp / ghost mcp server

Ghost MCP Server

A Model Context Protocol (MCP) server for interacting with Ghost CMS through LLM interfaces like Claude. Allow you to control your Ghost blog by simply asking Claude etc.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "mfydev-ghost-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@fanyangmeng/ghost-mcp"
      ],
      "env": {
        "GHOST_API_URL": "https://yourblog.com",
        "GHOST_API_VERSION": "v5.0",
        "GHOST_ADMIN_API_KEY": "your_admin_api_key"
      }
    }
  }
}

You can connect to Ghost via a Model Context Protocol (MCP) server to securely manage your Ghost blog through powerful natural language interfaces. This server exposes a rich set of operations for posts, users, members, newsletters, offers, tags, tiers, and more, while handling authentication and structured output for clear interactions with your Ghost CMS.

How to use

To use the Ghost MCP server with an MCP client, configure the client to connect to the local or remote MCP endpoint that runs the server. You will typically enable secure access to Ghost through the provided Admin API and specify the Ghost site URL, Admin API key, and API version in environment variables. Once configured, you can browse, read, create, update, and delete Ghost entities via natural-language prompts processed by the MCP server.

How to install

Prerequisites: You need Node.js and npm installed on your system.

Install and run the MCP server using the provided npm-based command shown in the usage example.

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

Additional setup notes

The MCP server uses JWT-based authentication for Ghost Admin API requests and offers comprehensive access to Ghost resources such as posts, members, newsletters, offers, and webhooks. Ensure you keep your Admin API key secure and rotate it if needed.

Security considerations

Store Ghost API credentials securely in environment variables and limit access to the MCP server. Use environment-specific keys and consider rotating credentials periodically.

Troubleshooting tips

If you encounter authentication or connection issues, verify that the GHOST_API_URL, GHOST_ADMIN_API_KEY, and GHOST_API_VERSION values are correct and that the Ghost Admin API is reachable from the MCP server host.

Notes

The server integrates with the official Ghost Admin API client for reliable interaction with your Ghost CMS and outputs detailed, human-friendly results for each operation.

Available tools

Browse Posts

List posts with optional filters, pagination, and ordering to locate content quickly.

Read Post

Retrieve a post by ID or slug for reading or display.

Add Post

Create a new post with a title, content, and status.

Edit Post

Update an existing post by ID to modify content or status.

Delete Post

Remove a post by ID from Ghost.

Browse Members

List members with filters and pagination to manage subscribers.

Read Member

Retrieve a member by ID or email to view details.

Add Member

Create a new member in Ghost.

Edit Member

Update member details such as name or email.

Delete Member

Remove a member from your Ghost site.

Browse Newsletters

List newsletters managed by Ghost.

Read Newsletter

Retrieve a newsletter by ID for viewing content.

Add Newsletter

Create a new newsletter in Ghost.

Edit Newsletter

Update newsletter details.

Delete Newsletter

Remove a newsletter.

Browse Offers

List offers available to members.

Read Offer

Retrieve an offer by ID.

Add Offer

Create a new offer.

Edit Offer

Update offer details.

Delete Offer

Remove an offer.

Browse Invites

List invites for new users or staff.

Add Invite

Create a new invite.

Delete Invite

Remove an invite.

Browse Roles

List roles and permissions.

Read Role

Retrieve a role by ID.

Browse Tags

List tags and organize content.

Read Tag

Retrieve a tag by ID or slug.

Add Tag

Create a new tag.

Edit Tag

Update tag details.

Delete Tag

Remove a tag.

Browse Tiers

List subscription tiers.

Read Tier

Retrieve a tier by ID.

Add Tier

Create a new tier.

Edit Tier

Update tier details.

Delete Tier

Remove a tier.

Browse Users

List admin users and staff.

Read User

Retrieve a user by ID or slug.

Edit User

Update user details.

Delete User

Remove a user.

Browse Webhooks

List webhooks for automated notifications.

Add Webhook

Create a new webhook.

Delete Webhook

Remove a webhook.