wp-cli-mcp

wp-cli-mcp

<p align="center"> <img src="https://img.shields.io/badge/WordPress-21759B?style=for-the-badge&logo=wordpress&logoColor=white" /> <img src="https://img.shields.io/badge/WP--CLI-0073AA?style=for-the-badge&logo=windowsterminal&logoColor=white" /> <img src="https://img.shields.io/badge/MCP-000?style=for-the-badge" /> <img src="https://img.shields.io/badge/Claude_Code-D97757?style=for-the-badge&logo=anthropic&logoColor=white" /> </p>

<p align="center"> <b>MCP server that gives AI tools full WordPress management via WP-CLI.</b><br/> Themes, plugins, posts, menus, users, database, scaffolding — 45+ tools. </p>

---

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.

Tools (30+)

| Category | Tools | |----------|-------| | Core | wp_core_version, wp_core_check_update | | Plugins | wp_plugin_list, wp_plugin_install, wp_plugin_activate, wp_plugin_deactivate, wp_plugin_delete, wp_plugin_search | | Themes | wp_theme_list, wp_theme_install, wp_theme_activate, wp_theme_delete | | Theme Files | wp_theme_file_list, wp_theme_file_read, wp_theme_file_write, wp_theme_file_delete | | Posts | wp_post_list, wp_post_get, wp_post_create, wp_post_update, wp_post_delete | | Post Meta | wp_post_meta_get, wp_post_meta_update, wp_post_meta_list | | Taxonomies | wp_term_list, wp_term_create | | Users | wp_user_list, wp_user_create | | Options | wp_option_get, wp_option_update | | Menus | wp_menu_list, wp_menu_create, wp_menu_item_add, wp_menu_location_assign | | Widgets | wp_sidebar_list, wp_widget_list | | Media | wp_media_import | | Database | wp_db_query, wp_db_export, wp_search_replace | | Scaffold | wp_scaffold_theme, wp_scaffold_plugin, wp_scaffold_block | | Cache | wp_rewrite_flush, wp_cache_flush | | PHP | wp_eval — execute any PHP in WordPress context | | Site | wp_site_info — full site overview | | Raw | wp_cli_raw — run any WP-CLI command |

Requirements

• WP-CLI installed and in PATH
• WordPress installation (local or accessible via SSH)
• Node.js 18+

Setup

Install

npm install -g wp-cli-mcp

Configure 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 | |----------|-------------|---------| | WP_PATH | Local WordPress path | /var/www/html | | WP_SSH | SSH connection string | user@host:/path/to/wp | | WP_URL | Site URL (multisite) | https://example.com |

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 content

Plugin 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 activated

Database 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 cache

Pairs 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