Ghost

The Ghost MCP Server lets you manage your Ghost CMS instance through model-assisted calls over a secure MCP interface. It provides authenticated access to posts, members, newsletters, offers, and more, enabling automation and streamlined content workflows while keeping connections stable and auditable.

How to use

You connect an MCP client to the Ghost MCP Server using either a remote HTTP endpoint or a local stdio-based command. The HTTP method is suitable for public or multi-tenant deployments, while the stdio method runs the MCP server locally via a command you execute. Once connected, you can browse, read, create, update, and delete content such as posts, members, newsletters, offers, and other Ghost resources through the client’s MCP-enabled commands. You’ll typically point your client at the MCP URL or start the local server and configure the client to reference that server, then perform CRUD operations against the Ghost Admin API.

For practical workflows, you’ll set up the connection in your MCP client configuration, then execute representative actions such as listing posts, creating a new post, updating a member’s details, or scheduling a newsletter. If you are using a public/deployed instance, provide the Ghost site URL and the Admin API key so the server can authenticate to Ghost. If you are running locally, ensure your client uses the local stdio server command and env vars you configured.

How to install

Prerequisites: you need Node.js and npm installed on your machine to run the MCP server or install the package as a client.

Method 1. Install via NPM (recommended for MCP clients)

npm install -g mcp-ghostcms
```} ,{

You can run it directly with npx without installing globally.

npx mcp-ghostcms

Configuration and deployment notes

The server supports two primary deployment modes: a public/remote HTTP MCP endpoint and a local stdio-based startup. For public/shared deployments, provide Ghost API credentials via the URL query parameters when using the HTTP endpoint. For local development, run the stdio command and point your client to the local server accordingly.

Important environment variables you’ll need when connecting to a Ghost instance are the following:

GHOST_API_URL=https://yourghostbloginstance.com
GHOST_ADMIN_API_KEY=your_admin_api_key
GHOST_API_VERSION=v6.0
GHOST_CONTENT_API_KEY=your_content_api_key (optional)

Security and diagnostics

The MCP server provides enhanced error handling with detailed status codes and response bodies. Use diagnostic tools to verify connectivity and configuration, such as testing the Admin API endpoint and echoing the current configuration with sensitive data masked.

VPS deployment and hosting

If you want to self-host on a VPS, you can deploy using Docker, Nginx, and a deployment workflow. The setup includes an Nginx reverse proxy, Docker containers, and a GitHub Actions workflow to automate deployment.

Notes for Claude Desktop users

Configure your Claude Desktop connection by adding an MCP server entry that references the local or remote endpoint with the appropriate environment variables.

Notes for Claude iOS and Claude Code

For Claude iOS, use the full MCP URL with query parameters in the Connectors feature. For Claude Code, add the server to your MCP settings with type streamable-http.

Available tools

browse_posts

List posts with optional filters, pagination, and ordering to gather content overview.

read_post

Retrieve a single post by ID or slug.

add_post

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

edit_post

Update an existing post by ID.

delete_post

Remove a post by ID.

browse_members

List members with filters and pagination.

read_member

Retrieve a member by ID or email.

add_member

Create a new member.

edit_member

Update member details.

delete_member

Remove a member.

browse_newsletters

List newsletters.

read_newsletter

Retrieve a newsletter by ID.

add_newsletter

Create a new newsletter.

edit_newsletter

Update newsletter details.

delete_newsletter

Remove a newsletter.

browse_offers

List offers.

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.

add_invite

Create a new invite.

delete_invite

Remove an invite.

browse_roles

List roles.

read_role

Retrieve a role by ID.

browse_tags

List tags.

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 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 users.

read_user

Retrieve a user by ID or slug.

edit_user

Update user details.

delete_user

Remove a user.

browse_webhooks

List webhooks.

add_webhook

Create a new webhook.

delete_webhook

Remove a webhook.

admin_site_ping

Test connectivity to the Ghost Admin API endpoint.

config_echo

Show current Ghost API configuration with the key masked.