Ghost
by
Ghost-MCP is a Model Context Protocol (MCP) server that enables interaction with Ghost CMS through Large Language Model (LLM) interfaces like Claude. It allows users to manage their Ghost blog by simply using natural language commands via an LLM.
Ghost Overview
What is Ghost-MCP?
Ghost-MCP is a Model Context Protocol (MCP) server that enables interaction with Ghost CMS through Large Language Model (LLM) interfaces like Claude. It allows users to manage their Ghost blog by simply using natural language commands via an LLM.
How to use Ghost-MCP?
Ghost-MCP is available as an NPM package (@fanyangmeng/ghost-mcp). To use it with MCP clients like Claude Desktop, you need to configure your claude_desktop_config.json file. This involves specifying the command to run npx @fanyangmeng/ghost-mcp and setting environment variables for your Ghost API URL, Admin API Key, and API Version.
Key Features of Ghost-MCP
- Secure API Requests: Utilizes
@tryghost/admin-apifor secure interactions. - Comprehensive Entity Access: Provides access to posts, users, members, tiers, offers, and newsletters.
- Advanced Search: Offers both fuzzy and exact matching for search functionalities.
- Human-Readable Output: Presents Ghost entities in a clear, understandable format.
- Robust Error Handling: Employs custom
GhostErrorexceptions for clear troubleshooting. - Integrated Logging: Supports logging via MCP context for enhanced diagnostics.
- Extensive Toolset: Exposes a wide range of tools for managing various Ghost CMS resources, including browsing, reading, adding, editing, and deleting posts, members, newsletters, offers, invites, roles, tags, tiers, users, and webhooks.
Use Cases of Ghost-MCP
- Content Management via LLM: Authors and editors can manage blog posts, update content, and schedule publications using natural language commands through LLMs.
- User and Member Management: Administrators can add, edit, or delete members and users on their Ghost blog without directly accessing the Ghost admin panel.
- Newsletter and Offer Management: Marketers can manage newsletters and promotional offers through an LLM interface, streamlining campaign management.
- Automated Blog Management: Developers can integrate Ghost-MCP into automated workflows to manage Ghost CMS programmatically using LLMs.
FAQ about Ghost-MCP
Q: What is the main benefit of using Ghost-MCP?
A: The main benefit is the ability to control and manage your Ghost blog using natural language through LLM interfaces, simplifying content and site administration.
Q: What are the breaking changes from the Python version to the TypeScript version?
A: The TypeScript version (v0.1.0) no longer requires Python dependencies, has a changed configuration method (now using Node.js environment variables), simplified Docker deployment, and a different installation process (now using NPM).
Q: What Ghost CMS resources can be managed with Ghost-MCP?
A: You can manage Posts, Members, Newsletters, Offers, Invites, Roles, Tags, Tiers, Users, and Webhooks.
Q: How does Ghost-MCP handle errors?
A: It uses a custom GhostError exception to provide clear and descriptive error messages for troubleshooting API communication and processing issues.
Ghost's README
Ghost MCP Server
‼️ Important Notice: Python to TypeScript Migration
I've completely rewritten the Ghost MCP Server from Python to TypeScript in this v0.1.0 release. This major change brings several benefits:
- Simplified installation: Now available as an NPM package (@fanyangmeng/ghost-mcp)
- Improved reliability: Uses the official @tryghost/admin-api client instead of custom implementation
- Better maintainability: TypeScript provides type safety and better code organization
- Streamlined configuration: Simple environment variable setup
Breaking Changes
- Python dependencies are no longer required
- Configuration method has changed (now using Node.js environment variables)
- Docker deployment has been simplified
- Different installation process (now using NPM)
Please see the below updated documentation for details on migrating from the Python version. If you encounter any issues, feel free to open an issue on GitHub.
A Model Context Protocol (MCP) server for interacting with Ghost CMS through LLM interfaces like Claude. This server provides secure and comprehensive access to your Ghost blog, leveraging JWT authentication and a rich set of MCP tools for managing posts, users, members, tiers, offers, and newsletters.
Features
- Secure Ghost Admin API requests with
@tryghost/admin-api - Comprehensive entity access including posts, users, members, tiers, offers, and newsletters
- Advanced search functionality with both fuzzy and exact matching options
- Detailed, human-readable output for Ghost entities
- Robust error handling using custom
GhostErrorexceptions - Integrated logging support via MCP context for enhanced troubleshooting
Usage
To use this with MCP clients, for instance, Claude Desktop, add the following to your claude_desktop_config.json:
{
"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"
}
}
}
}
Available Resources
The following Ghost CMS resources are available through this MCP server:
- Posts: Articles and content published on your Ghost site.
- Members: Registered users and subscribers of your site.
- Newsletters: Email newsletters managed and sent via Ghost.
- Offers: Promotional offers and discounts for members.
- Invites: Invitations for new users or staff to join your Ghost site.
- Roles: User roles and permissions within the Ghost admin.
- Tags: Organizational tags for posts and content.
- Tiers: Subscription tiers and plans for members.
- Users: Admin users and staff accounts.
- Webhooks: Automated event notifications to external services.
Available Tools
This MCP server exposes a comprehensive set of tools for managing your Ghost CMS via the Model Context Protocol. Each resource provides a set of operations, typically including browsing, reading, creating, editing, and deleting entities. Below is a summary of the available tools:
Posts
- Browse Posts: List posts with optional filters, pagination, and ordering.
- Read Post: Retrieve a 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.
Members
- 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.
Newsletters
- 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.
Offers
- 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.
Invites
- Browse Invites: List invites.
- Add Invite: Create a new invite.
- Delete Invite: Remove an invite.
Roles
- Browse Roles: List roles.
- Read Role: Retrieve a role by ID.
Tags
- 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.
Tiers
- 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.
Users
- Browse Users: List users.
- Read User: Retrieve a user by ID or slug.
- Edit User: Update user details.
- Delete User: Remove a user.
Webhooks
- Browse Webhooks: List webhooks.
- Add Webhook: Create a new webhook.
- Delete Webhook: Remove a webhook.
Each tool is accessible via the MCP protocol and can be invoked from compatible clients. For detailed parameter schemas and usage, see the source code in
src/tools/.
Error Handling
Ghost MCP Server employs a custom GhostError exception to handle API communication errors and processing issues. This ensures clear and descriptive error messages to assist with troubleshooting.
Contributing
- Fork repository
- Create feature branch
- Commit changes
- Create pull request
License
MIT
Ghost Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Related MCP Servers
Discover more MCP servers with similar functionality and use cases
Contentful MCP Server
by ivo-toby
Provides full integration with the Contentful Management API via the Model Context Protocol, enabling CRUD operations on entries, assets, spaces, comments, and bulk actions while handling pagination and supporting both stdio and StreamableHTTP transports.
DevHub CMS MCP
by devhub
Enables LLMs to manage businesses, locations, blog posts, and media within DevHub CMS through the Model Context Protocol.
Hashnode
by universal-mcp
Hashnode Universal MCP Server provides a standardized interface for interacting with Hashnode's tools and services through a unified API. It enables programmatic content management, automated publishing, and seamless third-party integrations with Hashnode.
Netdata
by netdata
Real-time, per‑second infrastructure monitoring platform that provides instant insights, auto‑discovery, edge‑based machine‑learning anomaly detection, and lightweight visualizations without requiring complex configuration.
Zed
OfficialClientby zed-industries
Provides real-time collaborative editing powered by Rust, enabling developers to edit code instantly across machines with a responsive, GPU-accelerated UI.
GitHub MCP Server
by github
Enables AI agents, assistants, and chatbots to interact with GitHub via natural‑language commands, providing read‑write access to repositories, issues, pull requests, workflows, security data and team activity.
Daytona
by daytonaio
Provides a secure, elastic sandbox environment for executing AI‑generated code with isolated runtimes and sub‑90 ms provisioning.
Roo Code
OfficialClientby RooCodeInc
An autonomous coding agent that lives inside VS Code, capable of generating, refactoring, debugging code, managing files, running terminal commands, controlling a browser, and adapting its behavior through custom modes and instructions.
SafeLine
by chaitin
Provides a self‑hosted web application firewall and reverse‑proxy that filters, monitors, and blocks malicious HTTP/S traffic, protecting web applications from attacks such as SQL injection, XSS, brute‑force, bot abuse, and various code injections.