English Français العربية

Wp CLI MCP

Community Data and databases

WordPress management via WP-CLI, locally or over SSH: themes, plugins, posts, menus, users, database, scaffolding and cache.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. wp-cli-mcp
  2. What can Claude do with this?
  3. Tools (30+)
  4. Requirements
  5. Setup
  6. Examples
  7. Pairs well with
  8. License

wp-cli-mcp

MCP server that gives AI tools full WordPress management via WP-CLI.

Themes, plugins, posts, menus, users, database, scaffolding — 45+ tools.

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+)

CategoryTools
Corewp_core_version, wp_core_check_update
Pluginswp_plugin_list, wp_plugin_install, wp_plugin_activate, wp_plugin_deactivate, wp_plugin_delete, wp_plugin_search
Themeswp_theme_list, wp_theme_install, wp_theme_activate, wp_theme_delete
Theme Fileswp_theme_file_list, wp_theme_file_read, wp_theme_file_write, wp_theme_file_delete
Postswp_post_list, wp_post_get, wp_post_create, wp_post_update, wp_post_delete
Post Metawp_post_meta_get, wp_post_meta_update, wp_post_meta_list
Taxonomieswp_term_list, wp_term_create
Userswp_user_list, wp_user_create
Optionswp_option_get, wp_option_update
Menuswp_menu_list, wp_menu_create, wp_menu_item_add, wp_menu_location_assign
Widgetswp_sidebar_list, wp_widget_list
Mediawp_media_import
Databasewp_db_query, wp_db_export, wp_search_replace
Scaffoldwp_scaffold_theme, wp_scaffold_plugin, wp_scaffold_block
Cachewp_rewrite_flush, wp_cache_flush
PHPwp_eval — execute any PHP in WordPress context
Sitewp_site_info — full site overview
Rawwp_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
VariableDescriptionExample
WP_PATHLocal WordPress path/var/www/html
WP_SSHSSH connection stringuser@host:/path/to/wp
WP_URLSite 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

Use all three together for complete AI-powered WordPress development.

License

MIT — Mustafa Vatandas

Frequently asked questions

What is Wp CLI MCP?

WordPress management via WP-CLI, locally or over SSH: themes, plugins, posts, menus, users, database, scaffolding and cache.

How do I install Wp CLI MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Wp CLI MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Wp CLI MCP?

It is published by mvtandas. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.