Back to search
ghost-mcp
MCP serverGitHub
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.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/mfydev--ghost-mcp)HTML
<a href="/listings/mfydev--ghost-mcp"><img src="/api/listings/mfydev--ghost-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 132 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Ghost MCP Server
- 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 `GhostError` exceptions
- - 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`:
- ```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
- 1. Fork repository
- 2. Create feature branch
- 3. Commit changes
- 4. Create pull request
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.