Ghost CMS MCP Server
A comprehensive Model Context Protocol (MCP) server for Ghost CMS that provides full automation capabilities for Ghost blogs through AI assistants like Claude Desktop, Cursor, and other MCP-compatible clients.
Developed by Sivasubramanian Ramanathan | hello@sivasub.com
Product Owner | Innovation Catalyst | FinTech Leader previously at Bank for International Settlements Innovation Hub, SingaporeThis project demonstrates technical innovation and product thinking skills, bridging the gap between complex technology (Model Context Protocol) and practical business applications (content management automation). Built as a showcase of cross-functional capabilities in product development, from conception to delivery.
✨ Key Features
- 🚀 Complete Ghost CMS Integration - Full CRUD operations for posts, pages, members, and more
- 🔐 Enterprise Security - JWT authentication with proper error handling and validation
- ⚡ Smart Performance - Built-in rate limiting, caching, and queue management
- 🎯 Bulk Operations - Efficient mass content updates and member management
- 📊 Production Ready - Comprehensive testing, CI/CD pipeline, and NPM distribution
- 🤖 AI-First Design - Native integration with Claude, Cursor, and MCP-compatible tools
📦 Quick Installation
For Claude Desktop
macOS/Linux:
npm install -g ghost-cms-mcp-server
Add to your Claude Desktop configuration:
{
"mcpServers": {
"ghost-cms": {
"command": "npx",
"args": ["-y", "ghost-cms-mcp-server"],
"env": {
"GHOST_URL": "https://your-site.ghost.io",
"GHOST_ADMIN_API_KEY": "your-admin-key",
"GHOST_CONTENT_API_KEY": "your-content-key"
}
}
}
}
Windows (PowerShell):
npm install -g ghost-cms-mcp-server
# Add similar configuration to %APPDATA%\Claude\claude_desktop_config.json
For Claude Code CLI
claude mcp add ghost-cms -- npx -y ghost-cms-mcp-server
⚙️ Configuration
Required Environment Variables
GHOST_URL=https://your-site.ghost.io
GHOST_ADMIN_API_KEY=your-admin-key-id:your-admin-secret
GHOST_CONTENT_API_KEY=your-content-api-key
Getting Your Ghost API Keys
- Go to your Ghost Admin panel → Integrations
- Click Add custom integration
- Copy the Admin API Key (format:
id:secret) - Copy the Content API Key
- Use your Ghost site URL
🛠️ Available Operations
Content Management
- Posts: Create, read, update, delete, publish, search, bulk operations
- Pages: Full CRUD operations for static pages
- Media: Upload images and files directly through the MCP interface
Audience Management
- Members: Create, update, import/export subscriber lists
- Tags: Organize content with custom tagging systems
- Newsletters: Manage email campaigns and subscriber segments
Site Administration
- Settings: Update site configuration and preferences
- Users: Manage authors and admin accounts
- Tiers: Configure membership and subscription options
Advanced Features
- Bulk Operations: Mass update or delete content with safety confirmations
- Search & Filtering: Advanced query capabilities with Ghost's filter syntax
- Real-time Sync: Immediate updates with conflict resolution
📋 Usage Examples
Create a Blog Post
// Through your AI assistant using the ghost_posts_create tool
{
"title": "Product Strategy in FinTech Innovation",
"html": "<p>Insights from working at the BIS Innovation Hub...</p>",
"status": "published",
"tags": ["fintech", "product-management", "innovation"],
"meta_title": "FinTech Product Strategy Guide",
"featured": true
}
Bulk Content Management
// Update multiple posts at once
{
"filter": "status:draft+created_at:>2024-01-01",
"data": {
"status": "published",
"tags": ["updated-content"]
}
}
Member Management
// Add new newsletter subscribers
{
"email": "subscriber@example.com",
"name": "New Subscriber",
"labels": ["newsletter", "fintech-insights"],
"subscribed": true
}
🧪 Technical Implementation
Architecture Highlights
- TypeScript: Full type safety with strict mode enabled
- Test-Driven Development: Comprehensive Jest test suite with >80% coverage
- Error Handling: Proper error boundaries with detailed messaging
- Performance: Request queuing, rate limiting, and intelligent caching
- Security: API key protection and input validation
Development Workflow
# Local development
git clone https://github.com/siva-sub/ghost-cms-mcp-server.git
cd ghost-cms-mcp-server
npm install
npm run dev
# Testing
npm test # Run all tests
npm run test:coverage # Generate coverage reports
npm run lint # Code quality checks
🎯 Product Innovation Showcase
This project demonstrates key product development skills:
🔍 Problem Identification: Recognized the gap between powerful Ghost CMS APIs and AI assistant capabilities
🚀 Solution Design: Created a bridge that makes content management conversational and intuitive
⚖️ Technical Trade-offs: Balanced feature completeness with performance and security considerations
📊 User Experience: Designed intuitive tool interfaces that work naturally with AI conversation flows
🔄 Iterative Development: Built with modularity to enable rapid feature expansion and adaptation
👨💼 About the Creator
Sivasubramanian Ramanathan is a Product Owner and Innovation Catalyst, previously at the Bank for International Settlements Innovation Hub in Singapore, specializing in FinTech innovation, CBDC research, and regulatory technology solutions.
Professional Focus Areas:
- Product Strategy: End-to-end product management from conception to delivery
- FinTech Innovation: CBDC design, digital finance, and regulatory technology
- Stakeholder Management: Coordinating with 19+ central banks and regulatory authorities
- Technical Leadership: Bridging business requirements with engineering implementation
Certifications:
- PMP® - Project Management Professional
- PSM II - Professional Scrum Master II
- PSPO II - Professional Scrum Product Owner II
Connect:
- 🌐 Website: sivasub.com
- 💼 GitHub: @siva-sub
- 📧 Email: hello@sivasub.com
- 📱 LinkedIn: LinkedIn Profile
- 📍 Location: Singapore
Recent Publications:
- Project Viridis: A Blueprint for Managing Climate-Related Financial Risk (BIS Innovation Hub, 2024)
- GenAI in Action: Transforming Data Use in SupTech (Irving Fisher Committee, 2025)
- Novel Approaches to Combat Money Laundering (OMFIF Sustainable Policy Institute, 2024)
📄 License
MIT License - feel free to use this project as inspiration for your own technical innovations.
Built by a Product Owner who codes – demonstrating the intersection of business strategy and technical execution.
⭐ Star this repository to show your support for product-driven development!