# Ghost CMS MCP Server
[](https://www.npmjs.com/package/ghost-cms-mcp-server)
[](https://github.com/siva-sub/ghost-cms-mcp-server/blob/main/LICENSE)
[](https://nodejs.org/)
[](https://www.typescriptlang.org/)
[](https://github.com/siva-sub/ghost-cms-mcp-server/actions)
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](https://sivasub.com) | [hello@sivasub.com](mailto:hello@sivasub.com)**
> **Product Owner | Innovation Catalyst | FinTech Leader** previously at Bank for International Settlements Innovation Hub, Singapore
>
> This 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:**
```bash
npm install -g ghost-cms-mcp-server
```
Add to your Claude Desktop configuration:
```json
{
"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):**
```powershell
npm install -g ghost-cms-mcp-server
# Add similar configuration to %APPDATA%\Claude\claude_desktop_config.json
```
### For Claude Code CLI
```bash
claude mcp add ghost-cms -- npx -y ghost-cms-mcp-server
```
## ⚙️ Configuration
### Required Environment Variables
```bash
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
1. Go to your Ghost Admin panel → **Integrations**
2. Click **Add custom integration**
3. Copy the **Admin API Key** (format: `id:secret`)
4. Copy the **Content API Key**
5. 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
```javascript
// 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
```javascript
// Update multiple posts at once
{
"filter": "status:draft+created_at:>2024-01-01",
"data": {
"status": "published",
"tags": ["updated-content"]
}
}
```
### Member Management
```javascript
// 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
```bash
# 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](https://sivasub.com)
- 💼 **GitHub**: [@siva-sub](https://github.com/siva-sub)
- 📧 **Email**: [hello@sivasub.com](mailto:hello@sivasub.com)
- 📱 **LinkedIn**: [LinkedIn Profile](https://linkedin.com/in/sivasub987)
- 📍 **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](https://github.com/siva-sub/ghost-cms-mcp-server) to show your support for product-driven development!
