Ghost

Provides programmatic access to Ghost CMS features via MCP for posts, pages, members, and more.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-mtane0412_ghost-mcp-server": {
      "command": "npx",
      "args": [
        "@mtane0412/ghost-mcp-server"
      ],
      "env": {
        "GHOST_URL": "https://your-ghost-blog.com",
        "GHOST_ADMIN_API_KEY": "your_admin_api_key"
      }
    }
  }
}

You can run a Ghost MCP Server locally to manage Ghost CMS features programmatically, including posts, pages, members, and images, via a unified MCP interface you access from your MCP client.

How to use

To interact with the Ghost MCP Server, you run it in your environment and connect to it from your MCP client. The server exposes endpoints you can invoke to perform common Ghost actions such as creating posts, updating pages, uploading images, and managing members. Use your MCP client’s standard request/response flow to call the available endpoints, handle responses, and chain actions (for example, create a post and then assign tags or publish it). Ensure your Ghost instance is reachable from the server and that you provide a valid Ghost Admin API key for authentication.

How to install

Prerequisites you need before installing are Node.js (v18 or higher recommended), a Ghost CMS instance, and a Ghost Admin API key.

Install the Ghost MCP Server package using npm.

npm install @mtane0412/ghost-mcp-server

Configuration

Set up a custom integration in Ghost to obtain the API key and configure the server to point at your Ghost instance.

Environment variables you will need to set for the server to connect to Ghost.

# macOS/Linux
export GHOST_URL="https://your-ghost-blog.com"
export GHOST_ADMIN_API_KEY="your_admin_api_key"

# Windows (PowerShell)
$env:GHOST_URL="https://your-ghost-blog.com"
$env:GHOST_ADMIN_API_KEY="your_admin_api_key"

Notes and tips

Alternatively, you can store these settings in a .env file to be loaded at startup.

GHOST_URL=https://your-ghost-blog.com
GHOST_ADMIN_API_KEY=your_admin_api_key

Troubleshooting

If you encounter connection or authentication issues, verify that the Ghost Admin API key is correct and that your Ghost instance is reachable from the environment running the MCP server. Check that the custom integration has the appropriate permissions and that the GHOST_URL matches your Ghost instance URL.

Starting the server

Once installed and configured, start the server using the standard run command for the package.

npx @mtane0412/ghost-mcp-server

Available tools

get_posts

Retrieves a list of blog posts with optional pagination.

get_post

Retrieves a single post by its ID.

search_posts

Searches for posts using a query string with optional limit.

create_post

Creates a new post with title, content, and optional status and visibility.

update_post

Updates an existing post by ID with new title, content, or status.

delete_post

Deletes a post by ID.

get_pages

Retrieves a list of pages with optional pagination and formats.

get_members

Retrieves a list of members with optional pagination and related data.

search_members

Searches for members using a query and optional related data.

upload_image

Uploads an image with an optional purpose for the image resource.