wp-cli-mcp
This server enables AI tools to manage a WordPress installation comprehensively through WP-CLI, working both locally and over SSH with multisite support.
Core Management: Check WordPress version and available core updates.
Plugin Management: List, install, activate, deactivate, delete, and search plugins from wordpress.org.
Theme Management: List, install, activate, and delete themes; scaffold new child themes.
Post/Content Management: List, get, create, update, and delete posts/pages of any post type; manage post meta.
User Management: List users and create new ones with specified roles.
Options Management: Get and update any WordPress site option.
Navigation Menus: List menus, create new menus, add items, and assign locations.
Media: Import media files into the WordPress library from a URL.
Database Operations: Execute raw SQL queries, export the database, and perform search-and-replace (with dry-run support).
Scaffolding: Generate skeleton code for child themes, plugins, and Gutenberg blocks.
Cache & Rewrites: Flush rewrite rules and the WordPress object cache.
Raw Access: Execute any arbitrary WP-CLI command or PHP code within the WordPress context for maximum flexibility.
Complements the official Automattic WordPress MCP by providing WP-CLI based tools alongside REST API tools for comprehensive WordPress management.
Pairs with Elementor MCP for complete page building workflows, complementing WordPress management with Elementor-specific tools for AI-powered development.
Enables scaffolding of custom Gutenberg blocks through WP-CLI, allowing AI agents to create and manage block-based content for WordPress sites.
Supports WooCommerce installation and management through WP-CLI commands, allowing AI agents to handle e-commerce functionality within WordPress sites.
Provides comprehensive WordPress management tools via WP-CLI, enabling AI agents to manage themes, plugins, posts, users, menus, database operations, and scaffolding for WordPress installations.
wp-cli-mcp
What can Claude do with this?
"Install WooCommerce and activate it"
"Create a new page called About Us with this content..."
"List all plugins and deactivate the ones I'm not using"
"Scaffold a new child theme called my-theme"
"Create a navigation menu with Home, About, Contact links"
"Search and replace old domain with new domain in database"
"Export the database before I make changes"
"Generate a custom Gutenberg block for testimonials"All powered by WP-CLI under the hood. Works locally or over SSH to remote servers.
Related MCP server: TypeScript WordPress MCP Server
Tools (30+)
Category | Tools |
Core |
|
Plugins |
|
Themes |
|
Theme Files |
|
Posts |
|
Post Meta |
|
Taxonomies |
|
Users |
|
Options |
|
Menus |
|
Widgets |
|
Media |
|
Database |
|
Scaffold |
|
Cache |
|
PHP |
|
Site |
|
Raw |
|
Requirements
WP-CLI installed and in PATH
WordPress installation (local or accessible via SSH)
Node.js 18+
Setup
Install
npm install -g wp-cli-mcpConfigure with Claude Code
Add to your Claude Code MCP settings (~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"wordpress": {
"command": "wp-cli-mcp",
"env": {
"WP_PATH": "/path/to/your/wordpress"
}
}
}
}Remote server via SSH
{
"mcpServers": {
"wordpress": {
"command": "wp-cli-mcp",
"env": {
"WP_SSH": "user@yourserver.com:/var/www/html"
}
}
}
}Environment Variables
Variable | Description | Example |
| Local WordPress path |
|
| SSH connection string |
|
| Site URL (multisite) |
|
Examples
Theme Development Workflow
You: "Scaffold a child theme based on twentytwentyfour"
Claude: Uses wp_scaffold_theme → creates child theme files
You: "Install and activate it"
Claude: Uses wp_theme_activate → theme is live
You: "Create the homepage with a hero section and 3 feature cards"
Claude: Uses wp_post_create → creates page with HTML contentPlugin Management
You: "What plugins do I have installed?"
Claude: Uses wp_plugin_list → shows all plugins with status
You: "Install Contact Form 7 and WooCommerce"
Claude: Uses wp_plugin_install twice → both installed and activatedDatabase Operations
You: "I'm migrating from staging.example.com to example.com"
Claude: Uses wp_db_export → backup first
Uses wp_search_replace (dry_run) → preview changes
Uses wp_search_replace → apply changes
Uses wp_cache_flush → clear cachePairs well with
Elementor MCP — 97 tools for Elementor page building
WordPress MCP — Official Automattic REST API tools
wordpress-claude-stack — CLAUDE.md + Cursor rules for WordPress
Use all three together for complete AI-powered WordPress development.
License
MIT — Mustafa Vatandas
Available Tools
34 toolswp_cache_flushB
Flush the WordPress object cache
Inputs: no named parameters.
wp_cli_rawC
Execute any WP-CLI command directly
Inputs: command (required).
wp_core_check_updateB
Check for WordPress core updates
Inputs: no named parameters.
wp_core_versionB
Get WordPress version
Inputs: no named parameters.
wp_db_exportC
Export database to SQL file
Inputs: filename.
wp_db_queryB
Execute a raw SQL query (read-only recommended)
Inputs: sql (required).
wp_media_importC
Import media from URL
Inputs: url (required), title.
wp_option_getB
Get a WordPress option value
Inputs: key (required).
wp_option_updateC
Update a WordPress option
Inputs: key (required), value (required).
wp_plugin_activateC
Activate an installed plugin
Inputs: slug (required).
wp_plugin_deactivateC
Deactivate a plugin
Inputs: slug (required).
wp_plugin_deleteC
Delete a plugin
Inputs: slug (required).
wp_plugin_installC
Install a plugin from wordpress.org
Inputs: slug (required), activate.
wp_plugin_listB
List all installed plugins with status
Inputs: no named parameters.
wp_plugin_searchC
Search wordpress.org plugin directory
Inputs: term (required).
wp_post_createC
Create a new post or page
Inputs: title (required), content (required), post_type, status.
wp_post_deleteC
Delete a post
Inputs: id (required), force.
wp_post_getC
Get a single post by ID
Inputs: id (required).
wp_post_listC
List posts of any type
Inputs: post_type, count.
wp_post_updateC
Update an existing post
Inputs: id (required), post_title, post_content, post_status.
wp_rewrite_flushB
Flush rewrite rules (fix permalink issues)
Inputs: no named parameters.
wp_scaffold_blockC
Generate a Gutenberg block skeleton
Inputs: slug (required), plugin.
wp_scaffold_pluginC
Generate a plugin skeleton
Inputs: slug (required).
wp_scaffold_themeC
Generate a child theme skeleton
Inputs: slug (required), theme_name.
wp_search_replaceC
Search and replace in database
Inputs: old_value (required), new_value (required), dry_run.
wp_theme_activateC
Activate a theme
Inputs: slug (required).
wp_theme_deleteC
Delete a theme
Inputs: slug (required).
wp_theme_installC
Install a theme from wordpress.org
Inputs: slug (required), activate.
wp_theme_listB
List all installed themes
Inputs: no named parameters.
wp_user_createC
Create a new user
Inputs: username (required), email (required), role.
wp_user_listB
List all users
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 34 tools
Every tool has a clearly distinct purpose targeting specific WordPress resources and actions. For example, wp_post_create, wp_post_update, and wp_post_delete are clearly differentiated for post management, and there are no overlapping tools that could cause confusion.
All tools follow a consistent wp_ prefix with verb_noun pattern (e.g., wp_post_create, wp_plugin_activate). The naming is uniform throughout, using snake_case consistently without any deviations or mixed conventions.
With 34 tools, the count is borderline high for a WordPress CLI server. While it covers many aspects comprehensively, it may feel heavy and could potentially overwhelm agents with its breadth, though each tool serves a specific purpose.
The tool set provides complete coverage for WordPress management, including core, plugins, themes, posts, users, database, and scaffolding. It supports full CRUD operations for key resources like posts and plugins, with no obvious gaps in the domain.
Maintenance
Related MCP Connectors
Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.
WordPress MCP server: publish posts, AI images, SEO and full site management, self-hosted
WordPress MCP server: generate SEO posts, AI images, autoblog & WooCommerce on your self-hosted site
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for WordPress automation that enables users to manage content, themes, and site configurations using AI-driven workflows and the WordPress REST API. It provides a wide array of tools for site planning, management, and optimization compatible with tools like Cursor and Claude.52 npm1ISC
- AlicenseNot gradedqualityDmaintenanceMCP server for WordPress content management that provides a secure interface for AI assistants to interact with WordPress sites, enabling content creation, editing, and media management without destructive operations.MIT
- AlicenseNot gradedqualityCmaintenanceTurns any WordPress site into an MCP server, allowing AI clients to directly control files, database, WP-CLI, PHP, content, and more through declarative abilities without writing code.3GPL 2.0
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that bridges AI assistants to WordPress, enabling natural-language management of posts, pages, media, comments, users, plugins, and settings across multiple sites simultaneously.1-