Package Exports
- mcp-wordpress
- mcp-wordpress/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mcp-wordpress) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
MCP WordPress Server

A comprehensive Model Context Protocol (MCP) server for WordPress management through Claude Desktop. Manage your WordPress sites with natural language through 59 powerful tools.
โก Quick Start
Choose your setup method:
- ๐ NPX Setup - Zero installation, always latest (Recommended)
- ๐ป NPM Setup - Local development
- ๐ณ Docker Setup - Containerized deployment
- ๐ฆ DTX Setup - Claude Desktop Extension
Ultra-Quick Start (NPX)
# Run directly with NPX (recommended)
npx -y mcp-wordpress
# Follow the setup wizard
npm run setup
Setup takes 2 minutes - the wizard guides you through WordPress connection and Claude Desktop configuration.
๐ Features
WordPress Management
- 59 WordPress Tools - Posts, pages, media, users, comments, categories, tags, site settings
- Multi-Site Support - Manage multiple WordPress sites from one configuration
- Flexible Authentication - App Passwords (recommended), JWT, Basic Auth, API Key
Performance & Monitoring
- โก Intelligent Caching - 50-70% performance improvement with multi-layer caching
- ๐ Real-Time Monitoring - Performance metrics, analytics, and optimization insights
- ๐ Production Ready - Security-reviewed, 95%+ test coverage, battle-tested
Developer Experience
- 100% TypeScript - Complete type safety and IntelliSense
- ๐ณ Docker Support - Containerized deployment for production
- ๐ Auto-Generated Docs - Complete API documentation with examples
- ๐ 100% Backward Compatible - Zero breaking changes
๐ Multi-Site Configuration
Perfect for agencies and developers managing multiple WordPress sites:
{
"sites": [
{
"id": "main-site",
"name": "Main WordPress Site",
"config": {
"WORDPRESS_SITE_URL": "https://site1.com",
"WORDPRESS_USERNAME": "admin",
"WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
}
},
{
"id": "client-blog",
"name": "Client Blog",
"config": {
"WORDPRESS_SITE_URL": "https://client-blog.com",
"WORDPRESS_USERNAME": "editor",
"WORDPRESS_APP_PASSWORD": "yyyy yyyy yyyy yyyy yyyy yyyy"
}
}
]
}
Use with site parameter: wp_list_posts --site="main-site"
๐ Complete Multi-Site Setup Guide
๐ Authentication Setup
WordPress Application Passwords (Recommended)
- WordPress Admin โ Users โ Profile
- Scroll to Application Passwords
- Enter name: "MCP WordPress Server"
- Click Add New Application Password
- Copy the generated password
Alternative Methods
- JWT Authentication - With JWT plugin
- Basic Authentication - Username/password (dev only)
- API Key Authentication - With API Key plugin
๐ Complete Authentication Guide
๐ Available Tools (59 Tools)
Content Management
- ๐ Posts (6 tools) - Create, edit, delete, list posts and revisions
- ๐ Pages (6 tools) - Manage static pages and revisions
- ๐ผ๏ธ Media (6 tools) - Upload, manage media library and files
User & Community
- ๐ฅ Users (6 tools) - User management and profiles
- ๐ฌ Comments (7 tools) - Comment moderation and management
- ๐ท๏ธ Taxonomies (10 tools) - Categories and tags management
Site Management
- โ๏ธ Site Settings (7 tools) - Site configuration and statistics
- ๐ Authentication (6 tools) - Auth testing and management
- โก Cache Management (4 tools) - Performance caching control
- ๐ Performance Monitoring (6 tools) - Real-time metrics and optimization
๐ Complete Tool Documentation
๐ค Claude Desktop Integration
Quick Prompts for Claude
Setup Help:
Set up MCP WordPress using NPX. My site: https://mysite.com, username: myuser. Help with application password creation and Claude Desktop configuration.
Content Management:
List my recent WordPress posts, then help me create a new post about [topic] with SEO-optimized content.
Site Analysis:
Check my WordPress site performance, cache statistics, and provide optimization recommendations.
Configuration Example
{
"mcpServers": {
"mcp-wordpress": {
"command": "npx",
"args": ["-y", "mcp-wordpress"],
"env": {
"WORDPRESS_SITE_URL": "https://your-site.com",
"WORDPRESS_USERNAME": "your-username",
"WORDPRESS_APP_PASSWORD": "your-app-password"
}
}
}
}
๐ Complete Claude Desktop Setup
๐งช Testing & Status
Current Test Status โ
- Main Test Suite: 207/207 passed (100%)
- Security Tests: 40/40 passed (100%)
- Performance Tests: 8/8 passed (100%)
- CI/CD Pipeline: Fully functional
Test Your Installation
# Check connection status
npm run status
# Run full test suite
npm test
# Quick validation
npm run test:fast
๐ Troubleshooting
Common Issues
"Cannot connect to WordPress"
- Verify
WORDPRESS_SITE_URL
- Test REST API:
curl https://your-site.com/wp-json/wp/v2/
- Verify
"Authentication failed"
- Check username and application password
- Ensure Application Passwords are enabled
- Run
npm run setup
to reconfigure
"Tools not appearing in Claude"
- Restart Claude Desktop after configuration
- Check Claude Desktop config file format
Get Help
# Debug mode
DEBUG=true npm run dev
# Connection test
npm run status
# Re-run setup wizard
npm run setup
๐ Documentation
User Guides
- NPX Setup - Quick start guide
- NPM Setup - Local development
- Docker Setup - Production deployment
- DTX Setup - Desktop extension
Technical Documentation
- API Documentation - Complete tool reference
- Performance Guide - Monitoring and optimization
- Caching Guide - Cache configuration and management
- Security Guide - Security best practices
Developer Resources
- Development Guide - Contributing and development
- API Reference - Technical API details
- Architecture Guide - System architecture
- Testing Guide - Test suite and CI/CD
๐ง Requirements
- WordPress 5.0+ with REST API enabled
- HTTPS recommended for production
- User with appropriate permissions
- Application Passwords enabled (WordPress 5.6+)
WordPress User Roles
Role | Access |
---|---|
Administrator | Full access to all functions |
Editor | Posts, pages, comments, media |
Author | Own posts and media |
Contributor | Own posts (drafts only) |
Subscriber | Read only |
๐ฆ Installation Options
NPM Package
# Global installation
npm install -g mcp-wordpress
# Direct usage (recommended)
npx -y mcp-wordpress
Docker Images
# Latest version
docker pull docdyhr/mcp-wordpress:latest
# Specific version
docker pull docdyhr/mcp-wordpress:1.3.1
Distribution Channels
- NPM:
mcp-wordpress
- Docker Hub:
docdyhr/mcp-wordpress
- GitHub: Latest releases
๐ Acknowledgments
Special thanks to Stephan Ferraro for the upstream project that inspired this implementation.
Ready to get started? Choose your setup method above and follow the guide - you'll be managing WordPress with Claude in minutes! ๐