MCP WordPress Server

You can manage WordPress sites through natural language with this MCP WordPress Server. It lets you perform content, site, and admin tasks across multiple WordPress installations from a single, centralized workflow, streamlining actions that would normally require navigating admin panels and manual forms.

How to use

You interact with your WordPress instances by connecting an MCP client to the server. This enables you to create posts, manage media, supervise users and comments, adjust site settings, and run maintenance tasks through natural-language prompts. Start simple by testing a connection, then perform common tasks like creating posts, uploading media, or updating pages. If you manage several sites, you can switch context to work on a specific site or run actions across all configured sites.

How to install

Prerequisites you need before installation include Node.js and/or npm, and a WordPress installation with REST API access and Application Passwords enabled. Follow these concrete steps to get started.

# Ensure Node.js and npm are available
node -v
npm -v

# Install the MCP WordPress client globally
npm install -g mcp-wordpress

# Or run directly with npx (always latest)
npx -y mcp-wordpress

# Optional: run the setup wizard to configure your first site
npm run setup

Configuration and examples

Configure how you connect to WordPress and define your sites. The following example shows how to configure a single WordPress site using a Claude Desktop integration via an MCP JSON configuration. It demonstrates the required environment variables and how to reference them from the client.

{
  "mcpServers": {
    "mcp-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-wordpress"],
      "env": {
        "WORDPRESS_SITE_URL": "https://myblog.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Multi-site configuration

If you manage multiple WordPress sites, you can configure a multi-site setup with a JSON file that lists each site and its access credentials. This enables you to target specific sites or run operations across all configured sites.

{
  "sites": [
    {
      "id": "main-corporate",
      "name": "Corporate Website",
      "config": {
        "WORDPRESS_SITE_URL": "https://company.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    },
    {
      "id": "client-restaurant",
      "name": "Restaurant Client",
      "config": {
        "WORDPRESS_SITE_URL": "https://bestrestaurant.com",
        "WORDPRESS_USERNAME": "editor",
        "WORDPRESS_APP_PASSWORD": "yyyy yyyy yyyy yyyy yyyy yyyy",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    },
    {
      "id": "client-ecommerce",
      "name": "E-commerce Client",
      "config": {
        "WORDPRESS_SITE_URL": "https://onlinestore.com",
        "WORDPRESS_USERNAME": "shopmanager",
        "WORDPRESS_APP_PASSWORD": "zzzz zzzz zzzz zzzz zzzz zzzz",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    }
  ]
}

Troubleshooting tips

If you run into connection or authentication issues, verify your WordPress site URL, test the REST API, and ensure Application Passwords are enabled for the configured user. Use the setup wizard again if you need to reconfigure credentials.

# Quick status check (if a status command exists in your setup)
npm run status

# Re-run the setup wizard to reconfigure credentials
npm run setup

Available tools

Posts

Create, edit, delete, list posts and revisions across WordPress installations.

Pages

Manage static pages and revisions across WordPress installations.

Media

Upload and manage media library items and files.

Users

User management and profile updates.

Comments

Moderate, approve, and manage comments.

Taxonomies

Manage categories and tags for content.

Site Settings

Configure site-wide settings and statistics.

Authentication

Test and manage authentication methods for WordPress connections.

Cache Management

Control caching behavior and invalidate caches.

Performance Monitoring

Monitor real-time performance metrics and optimize accordingly.