Skip to main content
Glama

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

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

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

License

MIT — Mustafa Vatandas

Available Tools

34 tools
wp_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_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

    B3.4/5.0

    Scored across 34 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      1
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Turns 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.
      3
      GPL 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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
      -