WordPress MCP Server

An MCP server for day-to-day WordPress maintenance across multiple client sites.

What it can do

• list configured sites
• inspect site health and pending updates
• list plugins and themes
• update plugins
• update themes
• update WordPress core
• create remote backups via SSH + WP-CLI

Requirements

• Python 3.11+
• mcp
• pydantic
• PyYAML
• SSH access to each WordPress host
• WP-CLI installed on each remote host

Install

Option A — install from the repo

git clone https://github.com/nextestudios/wordpress-mcp.git
cd wordpress-mcp
uv tool install .

Option B — install with pipx

git clone https://github.com/nextestudios/wordpress-mcp.git
cd wordpress-mcp
pipx install .

Both options install the wordpress-mcp command.

Configuration

Create ~/.hermes/wordpress-mcp.yaml:

sites:
  client-a:
    label: Client A
    ssh:
      host: your-server.example.com
      user: deploy
      port: 22
      key_path: ~/.ssh/id_ed25519
      path: /var/www/client-a/public_html
      wp_bin: wp
      shell: bash

You can also point the server at a different file with WORDPRESS_MCP_CONFIG.

Run locally

wordpress-mcp

Hermes config

Add this to ~/.hermes/config.yaml:

mcp_servers:
  wordpress:
    command: wordpress-mcp

Or add it interactively:

hermes mcp add wordpress --command wordpress-mcp

Restart Hermes and the tools will appear with the mcp_wordpress_* prefix.

Suggested workflow

1. wordpress_list_sites
2. wordpress_site_status
3. wordpress_site_backup
4. wordpress_site_update_plugins
5. wordpress_site_update_themes
6. wordpress_site_update_core
7. Re-check wordpress_site_status