What can you do with this server?

The WordPress MCP Server enables AI agents to fully manage WordPress sites through natural language commands with 190+ tools for comprehensive control. **Key Capabilities:** * **Content Management**: Create, update, delete, search, schedule, publish, and duplicate posts, pages, media, users, categories, tags, and comments with bulk operations support * **File System Operations**: Read, write, delete, copy, move, and list files within themes, plugins, and uploads directories with security validation and automatic backups * **Theme Management**: Activate, delete, create child themes, modify theme files, manage theme.json configurations, templates, template parts, and global styles for block themes (FSE) * **Plugin Management**: Activate, deactivate, delete plugins, and read/write plugin files with status checking * **Navigation & Menus**: Create, update, and delete menus and menu items; assign menus to theme locations with full hierarchy support * **User Management**: Create, update, delete users; manage roles, permissions, and capabilities; reassign content * **Custom Content Types**: Manage post types, taxonomies, and terms with detailed information retrieval * **Shortcodes & Cron Jobs**: List and execute shortcodes; schedule, unschedule, and manually run scheduled tasks * **Widgets**: Manage sidebars, widget areas, and widget types * **Database Operations**: Execute queries, manage options, and inspect tables * **SEO & Metadata**: Set meta descriptions, focus keywords, and custom metadata (compatible with Yoast SEO, Rank Math, All-in-One SEO) * **Site Configuration**: Get and update site settings, retrieve complete site information and API routes, test connections * **WooCommerce Integration**: Manage products, orders, customers, inventory, and reports * **Gutenberg Blocks**: Work with block types, patterns, reusable blocks, and templates * **Security Monitoring**: Check site health, updates, integrity, and debug logs * **Performance Optimization**: Manage cache, optimize database, process images, and convert to WebP * **Backup & Migration**: Create full/partial backups, restore, export/import, and clone sites **Security Features:** * Multi-layer validation with automatic backups before modifications * Restricted to allowed directories and safe file extensions * Malware pattern detection and PHP syntax validation * WordPress permission system enforcement * File size limits (10MB) **Integration Support:** Compatible with Claude Desktop, Cline, and any MCP-compatible AI platform.

Which integrations are available for this server?

Provides 12 tools for managing WordPress [Gutenberg](/mcp/servers/integrations/gutenberg) block editor features including block types, patterns, reusable blocks, and templates. Enables e-commerce management through [WooCommerce](/mcp/servers/integrations/woocommerce) integration with 15 tools for managing products, orders, customers, inventory, coupons, and reports. Provides comprehensive [WordPress](/mcp/servers/integrations/wordpress) site management with 190+ tools for content management, file system operations, theme customization, plugin control, menu management, custom post types, shortcodes, cron jobs, widgets, and database operations. Mentioned as an example plugin that can be managed through the plugin control tools, allowing activation and management of [Yoast](/mcp/servers/integrations/yoast) SEO functionality.

The WordPress MCP Server enables AI agents to fully manage WordPress sites through natural language commands with 190+ tools for comprehensive control.

Key Capabilities:

Content Management: Create, update, delete, search, schedule, publish, and duplicate posts, pages, media, users, categories, tags, and comments with bulk operations support
File System Operations: Read, write, delete, copy, move, and list files within themes, plugins, and uploads directories with security validation and automatic backups
Theme Management: Activate, delete, create child themes, modify theme files, manage theme.json configurations, templates, template parts, and global styles for block themes (FSE)
Plugin Management: Activate, deactivate, delete plugins, and read/write plugin files with status checking
Navigation & Menus: Create, update, and delete menus and menu items; assign menus to theme locations with full hierarchy support
User Management: Create, update, delete users; manage roles, permissions, and capabilities; reassign content
Custom Content Types: Manage post types, taxonomies, and terms with detailed information retrieval
Shortcodes & Cron Jobs: List and execute shortcodes; schedule, unschedule, and manually run scheduled tasks
Widgets: Manage sidebars, widget areas, and widget types
Database Operations: Execute queries, manage options, and inspect tables
SEO & Metadata: Set meta descriptions, focus keywords, and custom metadata (compatible with Yoast SEO, Rank Math, All-in-One SEO)
Site Configuration: Get and update site settings, retrieve complete site information and API routes, test connections
WooCommerce Integration: Manage products, orders, customers, inventory, and reports
Gutenberg Blocks: Work with block types, patterns, reusable blocks, and templates
Security Monitoring: Check site health, updates, integrity, and debug logs
Performance Optimization: Manage cache, optimize database, process images, and convert to WebP
Backup & Migration: Create full/partial backups, restore, export/import, and clone sites

Security Features:

Multi-layer validation with automatic backups before modifications
Restricted to allowed directories and safe file extensions
Malware pattern detection and PHP syntax validation
WordPress permission system enforcement
File size limits (10MB)

Integration Support: Compatible with Claude Desktop, Cline, and any MCP-compatible AI platform.

WordPress MCP Server

Also Available on glama.ai | Cursor.store

npm version License: MIT WordPress

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

💝 Support This Project

If this project helps you, consider supporting its development:

Cryptocurrency Donation

Select Coin	Select Network	Contract	Deposit Address
🪙 USDT (TetherUS)	🔗 TRX (Tron TRC20)	Ending in `jLj6t`	`TBJBb7fKyRdhqmWETyZoNP4X98mPk2Jxrt`

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 wpmcp@3.0.0

2. Configure

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

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

3. Install WordPress Plugin (Required)

Install wpmcp-plugin/wpmcp.zip to /wp-content/plugins/wpmcp-plugin/
Activate via WordPress Admin → Plugins → "WordPress MCP Server Plugin"
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

Category	Tools	What You Can Do
Posts (15)	create, update, delete, search, schedule, publish, duplicate, bulk	Manage all blog content
Pages (4)	create, update, delete, hierarchy	Build site structure
Media (5)	upload, update, delete, featured images	Manage images and files
Users (4)	create, update, delete, roles	User management
Categories (4)	create, update, delete, hierarchy	Organize content
Tags (2)	create, get	Tag content
Comments (4)	create, update, delete, moderate	Manage discussions
Settings (4)	get, update site settings	Configure WordPress
SEO (2)	meta description, focus keywords	Optimize for search
File System (8)	read, write, delete, copy, move	Edit any file
Theme Manager (13)	activate, child themes, theme.json, templates	Complete theme control
Plugin Manager (10)	activate, deactivate, read/write files	Full plugin control
Menu Manager (8)	create, add items, assign locations	Full navigation control
Custom Types (7)	get post types, taxonomies, manage terms	Advanced content types
Shortcodes (3)	list, execute, check existence	Shortcode system
Cron Jobs (5)	list, schedule, unschedule, run manually	Task scheduling
Widgets (6)	get sidebars, widgets, types, update	Widget management
Database (6)	execute queries, manage options, list tables	Database operations
WooCommerce (15)	products, orders, customers, inventory, coupons	E-commerce management
Gutenberg Blocks (12)	block types, patterns, reusable blocks, templates	Modern block editor
Security (7)	site health, updates, integrity, debug logs	Security monitoring
Performance (8)	cache, optimization, cleanup, image processing	Performance tuning

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"

// 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"

"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:

Install Basic Auth plugin
Use your WordPress admin username and password

WordPress.com:

Requires Business plan or higher
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

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

License

MIT License - see LICENSE

💝 Support This Project

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

Cryptocurrency Donation

Coin	Network	Contract Address	Deposit Address
🪙 USDT (TetherUS)	🔗 TRX (Tron TRC20)	Ending in `jLj6t`	`TBJBb7fKyRdhqmWETyZoNP4X98mPk2Jxrt`

Copy Address:

TBJBb7fKyRdhqmWETyZoNP4X98mPk2Jxrt

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

Built for AI-powered WordPress development 🚀

Install Server

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

WordPress MCP Server

WordPress MCP Server

💝 Support This Project

Quick Start

1. Install

2. Configure

3. Install WordPress Plugin (Required)

4. Use

Available Tools (130+)

What You Can Do

Content Management

Theme Customization

Menu Management Examples

Plugin Management

Menu Management

Custom Post Types & Taxonomies

Shortcodes

Cron Jobs & Scheduled Tasks

Widgets

File Operations

Security Features

WordPress Authentication

Project Structure

Development

Testing

API Examples

Create Post

Create Child Theme

Activate Plugin

Read Theme File

Write File

Contributing

License

💝 Support This Project

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API