WordPress MCP Server

Video Demo : https://youtu.be/6hwMqXQFKN0

💝 Support This Project

If this project helps you, consider supporting its development:

Cryptocurrency Donation

Your support helps maintain and improve this project! 🙏

WPMCP server gives AI agents complete control over WordPress sites. Connect it to Claude, Cline, or any MCP-compatible AI, and manage WordPress through natural language.

Key Capabilities:

• ✅ Content Management - Posts, pages, media, users, comments
• ✅ File System Access - Read and write theme/plugin files
• ✅ Theme Customization - Create child themes, modify styles, customize block themes
• ✅ Plugin Control - Activate, deactivate, and modify plugins
• ✅ Menu Management - Create menus, add items, assign to locations
• ✅ Custom Content Types - Manage post types and taxonomies
• ✅ Shortcodes & Cron - Execute shortcodes, schedule tasks
• ✅ Widget System - Manage sidebars and widgets
• ✅ Database Operations - Execute queries, manage options, inspect tables
• ✅ WooCommerce Integration - Products, orders, customers, inventory, reports
• ✅ Gutenberg Blocks - Block types, patterns, reusable blocks, templates
• ✅ Advanced SEO - Sitemaps, redirects, schema markup, Open Graph, analysis
• ✅ Security Monitoring - Site health, updates, integrity checks, debug logs
• ✅ Performance Optimization - Cache management, database optimization, image processing
• ✅ Backup & Migration - Full/partial backups, restore, export/import, cloning
• ✅ User Roles - Custom roles, capabilities, permissions, role management
• ✅ Complete Security - Multi-layer validation and automatic backups

Quick Start

1. Install

npm i -g [email protected]

2. Configure

Add to your MCP client (Claude Desktop, Cline, etc.):

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_PASSWORD": "your-app-password"
      }
    }
  }
}

3. Install WordPress Plugin (Required)

1. Install wpmcp-plugin/wpmcp.zip to /wp-content/plugins/wpmcp-plugin/
2. Activate via WordPress Admin → Plugins → "WordPress MCP Server Plugin"
3. Ensure you have edit_themes and edit_plugins capabilities

What the plugin enables:

• File system operations (read, write, delete, copy, move)
• Shortcode execution
• Cron job management
• All advanced WordPress features

See wpmcp-plugin/README.md for detailed setup guide.

4. Use

"Create a child theme called 'My Custom Theme'"
"Activate Akismet plugin"
"Read the style.css file from my theme"
"Create a blog post about WordPress and publish it"

Available Tools (130+)

👉 See WPMCP_TOOLS.MD for complete detailed list of all 130 tools.

What You Can Do

Content Management

"Create a blog post about AI and publish it"
"Upload an image and set it as featured image for post 5"
"Get all draft posts"
"Create a new page called 'About Us'"

Theme Customization

"Create a child theme of Twenty Twenty-Five"
"Read my theme's functions.php file"
"Add custom CSS to make headers blue"
"Get the theme.json configuration"
"List all files in my theme"

Menu Management Examples

// Create menu
{
  "name": "Main Navigation",
  "description": "Primary site menu"
}

// Add menu item
{
  "title": "Home",
  "url": "https://yoursite.com",
  "menus": 3
}

// Get menu locations
// No parameters needed

// Assign menu to location
{
  "location": "primary",
  "menuId": 3
}

Plugin Management

"Show me all installed plugins"
"Activate the Contact Form 7 plugin"
"Read the main WooCommerce plugin file"
"Deactivate Hello Dolly"
"Check if Yoast SEO is installed"

Menu Management

"Create a new menu called 'Main Navigation'"
"Add a Home link to the menu"
"Get all registered menu locations"
"Assign the Main Navigation menu to primary location"
"Show me all menu items in the Main menu"

Custom Post Types & Taxonomies

"Show me all registered post types"
"Get details for the 'page' post type"
"Get all taxonomies"
"Show me all categories"
"Create a new category called 'Technology'"

Shortcodes

"List all registered shortcodes"
"Execute [gallery ids='1,2,3']"
"Check if 'contact-form' shortcode exists"

Cron Jobs & Scheduled Tasks

"Show me all scheduled cron jobs"
"Schedule a daily backup task"
"Run WordPress cron manually"
"Get available cron schedules"

Widgets

"Get all widget areas"
"Show me all available widget types"
"Get widgets in the sidebar"
"List inactive widgets"

File Operations

"Read style.css from my theme"
"Create a new custom.css file in my theme"
"Copy functions.php to functions-backup.php"
"Delete old-template.php with backup"

Security Features

All operations are secure:

• ✅ Only allowed directories (themes, plugins, uploads)
• ✅ Only safe file extensions (.php, .css, .js, etc.)
• ✅ Malware pattern detection
• ✅ PHP syntax validation
• ✅ Automatic backups before changes
• ✅ WordPress permission system
• ✅ File size limits (10MB)

WordPress Authentication

Self-Hosted WordPress:

1. Install Basic Auth plugin
2. Use your WordPress admin username and password

WordPress.com:

1. Requires Business plan or higher
2. Generate Application Password in Settings → Security

Project Structure

src/tools/
├── posts.ts          # 15 post management tools
├── pages.ts          # 4 page tools
├── media.ts          # 5 media tools
├── filesystem.ts     # 8 file system tools
├── themes.ts         # 13 theme management tools
├── plugins.ts        # 10 plugin management tools
├── menus.ts          # 8 menu management tools
└── all-features.ts   # Users, categories, tags, comments, settings, SEO

filesystem-plugin/
└── wpmcp-filesystem.php  # Required for file operations

Development

# Clone repository
git clone https://github.com/RaheesAhmed/wordpress-mcp-server.git
cd wordpress-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run
npm start

Testing

All features tested on live WordPress:

• ✅ 21/21 tests passed
• ✅ File operations working
• ✅ Theme management verified
• ✅ Plugin control confirmed
• ✅ Security validated

API Examples

Create Post

{
  "title": "My Post",
  "content": "<p>Content here</p>",
  "status": "publish"
}

Create Child Theme

{
  "parentTheme": "twentytwentyfive",
  "childName": "My Custom Theme"
}

Activate Plugin

{
  "plugin": "akismet/akismet"
}

Read Theme File

{
  "theme": "mytheme",
  "filePath": "functions.php"
}

Write File

{
  "path": "wp-content/themes/mytheme/custom.css",
  "content": "/* Custom styles */",
  "createBackup": true
}

Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/name)
3. Commit changes (git commit -m 'Add feature')
4. Push to branch (git push origin feature/name)
5. Open Pull Request

License

MIT License - see LICENSE

💝 Support This Project

If you find this project valuable, consider supporting its continued development:

Cryptocurrency Donation

Copy Address:

TBJBb7fKyRdhqmWETyZoNP4X98mPk2Jxrt

Your contributions help keep this project active and growing! Thank you for your support! 🙏

Built for AI-powered WordPress development 🚀