Skip to content
Back to search

ghost-mcp

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mfydev--ghost-mcp/badge.svg)](/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)

  1. # Ghost MCP Server
  2. 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.
  3. ![demo](./assets/ghost-mcp-demo.gif)
  4. ## Features
  5. - Secure Ghost Admin API requests with `@tryghost/admin-api`
  6. - Comprehensive entity access including posts, users, members, tiers, offers, and newsletters
  7. - Advanced search functionality with both fuzzy and exact matching options
  8. - Detailed, human-readable output for Ghost entities
  9. - Robust error handling using custom `GhostError` exceptions
  10. - Integrated logging support via MCP context for enhanced troubleshooting
  11. ## Usage
  12. To use this with MCP clients, for instance, Claude Desktop, add the following to your `claude_desktop_config.json`:
  13. ```json
  14. {
  15. "mcpServers": {
  16. "ghost-mcp": {
  17. "command": "npx",
  18. "args": ["-y", "@fanyangmeng/ghost-mcp"],
  19. "env": {
  20. "GHOST_API_URL": "https://yourblog.com",
  21. "GHOST_ADMIN_API_KEY": "your_admin_api_key",
  22. "GHOST_API_VERSION": "v5.0"
  23. }
  24. }
  25. }
  26. }
  27. ```
  28. ## Available Resources
  29. The following Ghost CMS resources are available through this MCP server:
  30. - **Posts**: Articles and content published on your Ghost site.
  31. - **Members**: Registered users and subscribers of your site.
  32. - **Newsletters**: Email newsletters managed and sent via Ghost.
  33. - **Offers**: Promotional offers and discounts for members.
  34. - **Invites**: Invitations for new users or staff to join your Ghost site.
  35. - **Roles**: User roles and permissions within the Ghost admin.
  36. - **Tags**: Organizational tags for posts and content.
  37. - **Tiers**: Subscription tiers and plans for members.
  38. - **Users**: Admin users and staff accounts.
  39. - **Webhooks**: Automated event notifications to external services.
  40. ## Available Tools
  41. 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:
  42. ### Posts
  43. - **Browse Posts**: List posts with optional filters, pagination, and ordering.
  44. - **Read Post**: Retrieve a post by ID or slug.
  45. - **Add Post**: Create a new post with title, content, and status.
  46. - **Edit Post**: Update an existing post by ID.
  47. - **Delete Post**: Remove a post by ID.
  48. ### Members
  49. - **Browse Members**: List members with filters and pagination.
  50. - **Read Member**: Retrieve a member by ID or email.
  51. - **Add Member**: Create a new member.
  52. - **Edit Member**: Update member details.
  53. - **Delete Member**: Remove a member.
  54. ### Newsletters
  55. - **Browse Newsletters**: List newsletters.
  56. - **Read Newsletter**: Retrieve a newsletter by ID.
  57. - **Add Newsletter**: Create a new newsletter.
  58. - **Edit Newsletter**: Update newsletter details.
  59. - **Delete Newsletter**: Remove a newsletter.
  60. ### Offers
  61. - **Browse Offers**: List offers.
  62. - **Read Offer**: Retrieve an offer by ID.
  63. - **Add Offer**: Create a new offer.
  64. - **Edit Offer**: Update offer details.
  65. - **Delete Offer**: Remove an offer.
  66. ### Invites
  67. - **Browse Invites**: List invites.
  68. - **Add Invite**: Create a new invite.
  69. - **Delete Invite**: Remove an invite.
  70. ### Roles
  71. - **Browse Roles**: List roles.
  72. - **Read Role**: Retrieve a role by ID.
  73. ### Tags
  74. - **Browse Tags**: List tags.
  75. - **Read Tag**: Retrieve a tag by ID or slug.
  76. - **Add Tag**: Create a new tag.
  77. - **Edit Tag**: Update tag details.
  78. - **Delete Tag**: Remove a tag.
  79. ### Tiers
  80. - **Browse Tiers**: List tiers.
  81. - **Read Tier**: Retrieve a tier by ID.
  82. - **Add Tier**: Create a new tier.
  83. - **Edit Tier**: Update tier details.
  84. - **Delete Tier**: Remove a tier.
  85. ### Users
  86. - **Browse Users**: List users.
  87. - **Read User**: Retrieve a user by ID or slug.
  88. - **Edit User**: Update user details.
  89. - **Delete User**: Remove a user.
  90. ### Webhooks
  91. - **Browse Webhooks**: List webhooks.
  92. - **Add Webhook**: Create a new webhook.
  93. - **Delete Webhook**: Remove a webhook.
  94. > 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/`.
  95. ## Error Handling
  96. 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.
  97. ## Contributing
  98. 1. Fork repository
  99. 2. Create feature branch
  100. 3. Commit changes
  101. 4. Create pull request
  102. ## License
  103. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.