docdyhr/mcp-wordpress

🚀 MCP WordPress Server

🎯 Why This MCP Server?

Transform WordPress management from complex admin panels to simple conversations:

text
❌ Before: Login → Admin Panel → Navigate → Click → Fill Forms → Save
✅ After:  "Create a new blog post about AI trends with SEO optimization"

Key Advantages:

• 🏆 Most Complete: 59 tools vs 20-30 in alternatives
• ⚡ Fastest Setup: 2-click Claude Desktop installation via DXT
• 🔒 Production Ready: 2200+ tests, security audited, battle-tested
• 🎯 TypeScript Native: 100% type safety, best-in-class developer experience
• 🌐 Multi-Site: Manage unlimited WordPress sites from one place

🚀 Quick Start

Get up and running in under 5 minutes:

Prerequisites

• WordPress: Version 5.6+ with REST API enabled
• Claude Desktop: Latest version installed
• Application Password: Generated from WordPress admin panel

3-Step Setup

1️⃣ Generate WordPress Application Password

text
WordPress Admin → Users → Profile → Application Passwords → Add New

2️⃣ Install MCP Server (Choose One)

Option A: DXT Extension (Easiest)

bash
# Download and install in Claude Desktop
curl -L https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt -o mcp-wordpress.dxt
# Then: Claude Desktop → Extensions → Install → Select DXT file

Option B: NPM Global Install

bash
npm install -g mcp-wordpress

3️⃣ Test Your Connection

text
In Claude: "Test my WordPress connection"
Response: "✅ Authentication successful! Connected to: Your Site Name"

📺 https://github.com/docdyhr/mcp-wordpress/wiki/setup-video | 📖 Detailed Setup Guide

⚡ Installation Options

🏆 Recommended: Claude Desktop Extension (DXT)

Easiest installation - just 2 clicks!

1. Download: https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt (3.4MB)
2. Install: Claude Desktop → Extensions → Install → Select DXT file
3. Configure: Enter your WordPress site URL and credentials

✅ Zero command line required ✅ Easy updates ✅ Built-in security

📖 Complete DXT Setup Guide →

🚀 Alternative: NPX (Power Users)

bash
# Run directly - always latest version
npx -y mcp-wordpress

# Interactive setup wizard
npm run setup

🔧 Other Options

• 💻 NPM Setup - Local development
• 🐳 Docker Setup - Production deployment
• 🔧 Manual Build - Custom builds

📋 Configuration Examples

Single Site Setup

Environment Variables (.env)

bash
WORDPRESS_SITE_URL=https://myblog.com
WORDPRESS_USERNAME=admin
WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
WORDPRESS_AUTH_METHOD=app-password

Claude Desktop Config

json
{
  "mcpServers": {
    "mcp-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-wordpress"],
      "env": {
        "WORDPRESS_SITE_URL": "https://myblog.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Multi-Site Agency Setup

Configuration File (mcp-wordpress.config.json)

json
{
  "sites": [
    {
      "id": "main-corporate",
      "name": "Corporate Website",
      "config": {
        "WORDPRESS_SITE_URL": "https://company.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    },
    {
      "id": "client-restaurant",
      "name": "Restaurant Client",
      "config": {
        "WORDPRESS_SITE_URL": "https://bestrestaurant.com",
        "WORDPRESS_USERNAME": "editor",
        "WORDPRESS_APP_PASSWORD": "yyyy yyyy yyyy yyyy yyyy yyyy",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    },
    {
      "id": "client-ecommerce",
      "name": "E-commerce Client",
      "config": {
        "WORDPRESS_SITE_URL": "https://onlinestore.com",
        "WORDPRESS_USERNAME": "shopmanager",
        "WORDPRESS_APP_PASSWORD": "zzzz zzzz zzzz zzzz zzzz zzzz",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    }
  ]
}

Development Environment

Local WordPress with Docker

yaml
# docker-compose.yml
version: "3.8"
services:
  wordpress:
    image: wordpress:latest
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - wordpress_data:/var/www/html

  db:
    image: mysql:8.0
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
      MYSQL_ROOT_PASSWORD: rootpassword
    volumes:
      - db_data:/var/lib/mysql

volumes:
  wordpress_data:
  db_data:

MCP WordPress Development Config

json
{
  "sites": [
    {
      "id": "local-dev",
      "name": "Local Development",
      "config": {
        "WORDPRESS_SITE_URL": "http://localhost:8080",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "dev-password-here",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    }
  ]
}

Production Deployment

Server Environment Variables

bash
# /etc/environment or systemd service
WORDPRESS_SITE_URL=https://production-site.com
WORDPRESS_USERNAME=api-user
WORDPRESS_APP_PASSWORD=secure-production-password
WORDPRESS_AUTH_METHOD=app-password
NODE_ENV=production
CACHE_ENABLED=true
CACHE_TTL=3600
RATE_LIMIT_ENABLED=true
DEBUG=false

Docker Production Setup

dockerfile
# Dockerfile.production
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist/ ./dist/
EXPOSE 3000
USER node
CMD ["node", "dist/index.js"]

JWT Authentication Setup

WordPress Plugin Configuration

php
// wp-config.php
define('JWT_AUTH_SECRET_KEY', 'your-secret-key-here');
define('JWT_AUTH_CORS_ENABLE', true);

MCP Configuration

json
{
  "sites": [
    {
      "id": "jwt-site",
      "name": "JWT Authentication Site",
      "config": {
        "WORDPRESS_SITE_URL": "https://site-with-jwt.com",
        "WORDPRESS_USERNAME": "api-user",
        "WORDPRESS_PASSWORD": "user-password",
        "WORDPRESS_AUTH_METHOD": "jwt"
      }
    }
  ]
}

🌟 What Makes This Special

🏆 Feature Comparison

🚀 Core Capabilities

WordPress Management

• 59 WordPress Tools across 10 categories
• Multi-Site Support - Manage unlimited WordPress installations
• Flexible Authentication - App Passwords, JWT, Basic Auth, API Key
• Real-Time Sync - Instant updates across all connected tools

Performance & Reliability

• ⚡ Intelligent Caching - 50-70% performance improvement
• 📊 Real-Time Monitoring - Performance metrics and optimization insights
• 🔒 Production Ready - Security-reviewed, 96.17% line coverage with Vitest testing framework
• 🔄 Zero Downtime - Graceful error handling and automatic recovery

Developer Experience

• 100% TypeScript - Complete type safety and IntelliSense
• 🐳 Docker Support - Production-ready containerization
• 📚 Auto-Generated Docs - API documentation with live examples
• 🔧 Extensible - Custom tool development framework

🌐 Multi-Site Configuration

Perfect for agencies and developers managing multiple WordPress sites:

json
{
  "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)

1. WordPress Admin → Users → Profile
2. Scroll to Application Passwords
3. Enter name: "MCP WordPress Server"
4. Click Add New Application Password
5. 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 (Monitoring & Admin)

• ⚙️ 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 | Live API Reference

🤖 Claude Desktop Integration

🎯 Real-World Use Cases

Content Creation & Management:

text
💬 "Analyze my top 10 blog posts and create a new post about emerging trends"
💬 "Upload these 5 images and create a photo gallery page with SEO optimization"
💬 "Review all pending comments and approve the legitimate ones"

Site Management & Analytics:

text
💬 "Check my WordPress site performance and provide optimization recommendations"
💬 "Create a new user account for my freelance writer with editor permissions"
💬 "Backup my site settings and show me cache performance statistics"

Bulk Operations:

text
💬 "Update all posts from 2023 to include my new author bio"
💬 "Find all images over 1MB and suggest compression strategies"
💬 "List all users who haven't logged in for 6 months"

⚙️ Configuration Methods

Option 1: DXT Extension (Recommended)

No configuration needed - built-in secure credential management!

Option 2: NPX in Claude Desktop

json
{
  "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 Integration Guide

📚 Examples

Basic Content Management

Create and Publish a Blog Post

text
You: "Create a new blog post titled 'AI Revolution in 2024' with content about recent AI breakthroughs"
Claude: "I'll create that blog post for you..."
Result: ✅ Post "AI Revolution in 2024" created successfully (ID: 123)

Media Management

text
You: "Upload the image at /path/to/image.jpg and set it as featured image for post 123"
Claude: "I'll upload that image and set it as the featured image..."
Result: ✅ Image uploaded (ID: 456) and set as featured image

Advanced Workflows

SEO-Optimized Content Creation

text
You: "Create an SEO-optimized blog post about 'WordPress Security Best Practices' with:
     - Focus keyword: 'WordPress security'
     - Meta description
     - Proper heading structure
     - At least 1500 words"

Claude: "I'll create a comprehensive SEO-optimized post on WordPress security..."

Bulk Operations

text
You: "Find all draft posts older than 30 days and provide a summary"
You: "Update all posts in category 'News' to include a disclaimer at the end"
You: "Delete all spam comments from the last week"

Site Management

Performance Monitoring

text
You: "Analyze my site's performance and suggest optimizations"
Claude: "Let me check your site's performance metrics...
         - Cache hit rate: 67%
         - Average response time: 245ms
         - Recommendations: Enable object caching, optimize images..."

User Management

text
You: "Create a new editor account for john@example.com with a secure password"
You: "List all users who haven't logged in for 90 days"
You: "Update Sarah's role from Author to Editor"

Multi-Site Management

Working with Multiple Sites

text
You: "List all posts from my client-blog site"
Claude: "I'll list the posts from the client-blog site..."

You: "Compare traffic between main-site and client-blog"
Claude: "Here's a comparison of both sites..."

🎨 Real-World Workflows

Content Marketing Agency Workflow

Scenario: Managing 20+ client blogs with consistent SEO optimization

text
💬 "Analyze the top 5 performing posts across all sites and create similar content for underperforming clients"
💬 "Batch update all client sites with the new privacy policy footer"
💬 "Generate a weekly performance report comparing all client sites"
💬 "Create social media snippets from the latest blog posts on each site"

E-commerce Store Management

Scenario: Managing product launches and inventory updates

text
💬 "Create a product launch post with gallery, specifications, and pricing for the new iPhone case"
💬 "Update all 'out of stock' products with restock notifications"
💬 "Generate product comparison pages for similar items"
💬 "Create seasonal landing pages with current promotions"

News Website Operations

Scenario: Breaking news and content moderation

text
💬 "Publish breaking news about the tech merger with social media integration"
💬 "Moderate comments on controversial articles and flag inappropriate content"
💬 "Create topic clusters around trending news stories"
💬 "Schedule social media posts for peak engagement times"

Educational Institution Portal

Scenario: Course management and student communications

text
💬 "Create course announcement pages with enrollment forms"
💬 "Update faculty profiles with new publications and achievements"
💬 "Generate student newsletter with upcoming events and deadlines"
💬 "Moderate discussion forums and highlight valuable contributions"

Non-Profit Organization

Scenario: Fundraising campaigns and volunteer coordination

text
💬 "Create donation campaign pages with progress tracking"
💬 "Update volunteer opportunity listings with current needs"
💬 "Generate impact reports showing donation effectiveness"
💬 "Create event registration pages with automated confirmations"

🚀 Advanced Automation Examples

Smart Content Workflows

Automated SEO Optimization

text
You: "Optimize all posts from the last month for better SEO performance"
Claude: "I'll analyze and optimize your recent posts...
- Analyzed 15 posts from the last 30 days
- Updated meta descriptions for 12 posts
- Added focus keywords to 8 posts
- Optimized heading structure in 10 posts
- Improved internal linking in 15 posts
- Average SEO score improved from 67% to 89%"

Two additional tools are available: wp_seo_track_serp_positions and wp_seo_keyword_research. By default they estimate keyword coverage from your WordPress content. You can upgrade to real Google Search Console data:

Google Search Console Integration (optional)

1. Create OAuth2 credentials (Desktop app) in Google Cloud Console and enable the Search Console API.
2. Run the setup helper to obtain a refresh token:

   bash
   GOOGLE_CLIENT_ID=xxx GOOGLE_CLIENT_SECRET=yyy node scripts/google-auth.mjs
   

3. Add the credentials to your .env:

   bash
   SEO_PROVIDER_SEARCH_CONSOLE=true
   GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
   GOOGLE_CLIENT_SECRET=GOCSPX-your-secret
   GOOGLE_REFRESH_TOKEN=1//your-refresh-token
   

When enabled, wp_seo_track_serp_positions returns real average positions, clicks, impressions, and CTR from your Search Console property. wp_seo_keyword_research returns top queries containing the seed keyword, sorted by impressions. If credentials are missing or the API is unreachable, both tools fall back silently to WordPress content analysis.

Content Gap Analysis

text
You: "Identify content gaps in our blog compared to competitor topics"
Claude: "After analyzing your content and common industry topics...
- Missing topics: 'AI in Healthcare', 'Remote Work Security', 'Green Technology'
- Underperforming categories: 'Tutorials' (only 3 posts vs 15+ needed)
- Recommended: 8 new posts to fill major gaps
- Priority topics based on search volume and competition"

Maintenance Automation

Site Health Monitoring

text
You: "Perform a comprehensive site health check and fix any issues"
Claude: "Running complete site diagnostics...
- ✅ SSL certificate valid (expires: March 15, 2025)
- ⚠️ 3 broken internal links found and flagged
- ✅ All images optimized (average load time: 1.2s)
- ⚠️ 2 plugins need updates
- ✅ Database optimized (reduced size by 15%)
- ✅ Cache performance: 78% hit rate"

User Management Automation

text
You: "Clean up user accounts and update permissions for the new team structure"
Claude: "Updating user management...
- Deactivated 5 inactive accounts (no login >6 months)
- Updated 12 user roles to match new org chart
- Created 3 new editor accounts for content team
- Set up role-based content access restrictions
- Configured automated welcome emails for new users"

Performance Optimization

Intelligent Cache Management

text
You: "Analyze site performance and implement optimal caching strategies"
Claude: "Implementing performance optimizations...
- Enabled object caching (40% speed improvement)
- Configured CDN for static assets
- Optimized database queries (reduced load time by 25%)
- Set up page caching with smart invalidation
- Compressed and optimized 47 images
- Site speed improved from 3.2s to 1.8s average load time"

🎯 Industry-Specific Solutions

Healthcare Practices

text
💬 "Create HIPAA-compliant patient information pages with secure forms"
💬 "Update doctor profiles with latest certifications and specializations"
💬 "Generate appointment booking pages with calendar integration"
💬 "Create health education content with medical disclaimers"

Legal Firms

text
💬 "Create practice area pages with case study examples"
💬 "Update attorney profiles with recent wins and bar admissions"
💬 "Generate client intake forms with confidentiality notices"
💬 "Create legal blog posts with proper citations and disclaimers"

Real Estate Agencies

text
💬 "Create property listing pages with virtual tour embeds"
💬 "Update agent profiles with recent sales and market statistics"
💬 "Generate neighborhood guide pages with local amenities"
💬 "Create mortgage calculator pages with current rates"

Restaurants & Food Service

text
💬 "Create menu pages with dietary restriction filters"
💬 "Update chef profiles with signature dishes and cooking philosophy"
💬 "Generate event booking pages for private dining"
💬 "Create food blog posts with recipe cards and nutritional information"

📖 More Examples | Use Case Library

🛠️ Troubleshooting Guide

Quick Diagnostics

Connection Issues

bash
# Test WordPress connection
npm run status

# Debug mode with detailed logs
DEBUG=true npm run dev

# Test specific site in multi-site setup
npm run status -- --site="your-site-id"

Authentication Problems

bash
# Verify WordPress application password
curl -u username:app_password https://your-site.com/wp-json/wp/v2/users/me

# Test authentication with different methods
npm run test:auth

# Regenerate application password
npm run setup

Performance Issues

bash
# Check cache performance
npm run test:cache

# Monitor real-time performance
npm run test:performance

# Clear all caches
rm -rf cache/ && npm run dev

Common Error Solutions