Ghost Admin API MCP server

The Ghost MCP Server is a powerful tool that integrates with the Ghost Admin API, enabling programmatic access to your Ghost CMS features. This server allows you to manage posts, pages, tags, authors, members, and even upload images through the Model Context Protocol.

Getting Started

Prerequisites

Before installing the Ghost MCP Server, ensure you have:

• Node.js (v18 or higher recommended)
• A running Ghost CMS instance
• Ghost Admin API key

Installation

Install the package using npm:

npm install @mtane0412/ghost-mcp-server

Configuration

Setting Up Ghost Integration

1. Create a new custom integration in your Ghost Admin dashboard:
   • Navigate to Settings > Integrations
   • Click "Add custom integration"
   • Name your integration and save it
   • Copy the Admin API Key

Environment Configuration

Set the required environment variables using one of these methods:

Method 1: Command Line (macOS/Linux)

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

Method 2: Command Line (Windows PowerShell)

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

Method 3: Using a .env File Create a .env file in your project root:

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

Running the Server

Start the MCP server with:

npx @mtane0412/ghost-mcp-server

Available Tools

The server provides several tools for interacting with your Ghost CMS:

Post Management

Retrieving Posts

get_posts - List multiple posts

{
  "limit": "number", 
  "page": "number"
}

get_post - Get a specific post

{
  "id": "string"
}

search_posts - Find posts by keyword

{
  "query": "string",
  "limit": "number"
}

Creating and Updating Posts

create_post - Add a new post

{
  "title": "string",
  "html": "string",
  "lexical": "string",
  "status": "string",
  "visibility": "string"
}

update_post - Modify an existing post

{
  "id": "string",
  "title": "string",
  "html": "string",
  "lexical": "string",
  "status": "string"
}

delete_post - Remove a post

{
  "id": "string"
}

Page Management

get_pages - List pages

{
  "limit": "number",
  "page": "number",
  "order": "string",
  "formats": ["string"],
  "include": ["string"]
}

Member Management

get_members - List members

{
  "limit": "number",
  "page": "number",
  "order": "string",
  "include": ["string"]
}

search_members - Find members by keyword

{
  "query": "string",
  "limit": "number",
  "include": ["string"]
}

Image Management

upload_image - Add images to your Ghost site

{
  "file": "string",
  "purpose": "string"
}

Debugging Tips

Since the MCP server communicates over stdio, you can use the MCP Inspector for debugging:

npm run inspect

This will provide a URL to access debugging tools in your browser, making it easier to troubleshoot any issues with your requests or responses.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "ghost-mcp-server" '{"command":"npx","args":["@mtane0412/ghost-mcp-server"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "ghost-mcp-server": {
            "command": "npx",
            "args": [
                "@mtane0412/ghost-mcp-server"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

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

2. Add this to your configuration file:

{
    "mcpServers": {
        "ghost-mcp-server": {
            "command": "npx",
            "args": [
                "@mtane0412/ghost-mcp-server"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect