MCP Server

WordPress MCP Server MCP Server

Name: WordPress MCP Server MCP Server
Author: io.github.rnaga

io.github.rnaga/wp-mcp

Repository Registry

What is the WordPress MCP Server MCP server?

MCP server for WordPress. Manage posts, users, comments, terms, metadata, and settings.

How to install WordPress MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

LOCAL_USERNAME
required
WordPress username to assume for capability checks
WP_DB_HOST
required
WordPress database host
WP_DB_PORT
WordPress database port
WP_DB_NAME
required
WordPress database name
WP_DB_USER
required
WordPress database user
WP_DB_PASSWORD
required
secret
WordPress database password
LOCAL_MULTISITE
Enable WordPress multisite mode
LOCAL_DEFAULT_BLOG_ID
Default blog ID for multisite
LOCAL_DEFAULT_SITE_ID
Default site ID for multisite
LOCAL_SSL_ENABLED
Enable SSL for database connection
LOCAL_SSL_CA_FILEPATH
Path to SSL CA certificate file
LOCAL_SSL_CERT_FILEPATH
Path to SSL certificate file
LOCAL_SSL_KEY_FILEPATH
Path to SSL key file

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rnaga/wp-mcp",
        "-y",
        "local",
        "start"
      ],
      "env": {
        "LOCAL_USERNAME": "<YOUR_LOCAL_USERNAME>",
        "WP_DB_HOST": "<YOUR_WP_DB_HOST>",
        "WP_DB_PORT": "<YOUR_WP_DB_PORT>",
        "WP_DB_NAME": "<YOUR_WP_DB_NAME>",
        "WP_DB_USER": "<YOUR_WP_DB_USER>",
        "WP_DB_PASSWORD": "<YOUR_WP_DB_PASSWORD>",
        "LOCAL_MULTISITE": "<YOUR_LOCAL_MULTISITE>",
        "LOCAL_DEFAULT_BLOG_ID": "<YOUR_LOCAL_DEFAULT_BLOG_ID>",
        "LOCAL_DEFAULT_SITE_ID": "<YOUR_LOCAL_DEFAULT_SITE_ID>",
        "LOCAL_SSL_ENABLED": "<YOUR_LOCAL_SSL_ENABLED>",
        "LOCAL_SSL_CA_FILEPATH": "<YOUR_LOCAL_SSL_CA_FILEPATH>",
        "LOCAL_SSL_CERT_FILEPATH": "<YOUR_LOCAL_SSL_CERT_FILEPATH>",
        "LOCAL_SSL_KEY_FILEPATH": "<YOUR_LOCAL_SSL_KEY_FILEPATH>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "wp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rnaga/wp-mcp",
        "-y",
        "local",
        "start"
      ],
      "env": {
        "LOCAL_USERNAME": "<YOUR_LOCAL_USERNAME>",
        "WP_DB_HOST": "<YOUR_WP_DB_HOST>",
        "WP_DB_PORT": "<YOUR_WP_DB_PORT>",
        "WP_DB_NAME": "<YOUR_WP_DB_NAME>",
        "WP_DB_USER": "<YOUR_WP_DB_USER>",
        "WP_DB_PASSWORD": "<YOUR_WP_DB_PASSWORD>",
        "LOCAL_MULTISITE": "<YOUR_LOCAL_MULTISITE>",
        "LOCAL_DEFAULT_BLOG_ID": "<YOUR_LOCAL_DEFAULT_BLOG_ID>",
        "LOCAL_DEFAULT_SITE_ID": "<YOUR_LOCAL_DEFAULT_SITE_ID>",
        "LOCAL_SSL_ENABLED": "<YOUR_LOCAL_SSL_ENABLED>",
        "LOCAL_SSL_CA_FILEPATH": "<YOUR_LOCAL_SSL_CA_FILEPATH>",
        "LOCAL_SSL_CERT_FILEPATH": "<YOUR_LOCAL_SSL_CERT_FILEPATH>",
        "LOCAL_SSL_KEY_FILEPATH": "<YOUR_LOCAL_SSL_KEY_FILEPATH>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rnaga/wp-mcp",
        "-y",
        "local",
        "start"
      ],
      "env": {
        "LOCAL_USERNAME": "<YOUR_LOCAL_USERNAME>",
        "WP_DB_HOST": "<YOUR_WP_DB_HOST>",
        "WP_DB_PORT": "<YOUR_WP_DB_PORT>",
        "WP_DB_NAME": "<YOUR_WP_DB_NAME>",
        "WP_DB_USER": "<YOUR_WP_DB_USER>",
        "WP_DB_PASSWORD": "<YOUR_WP_DB_PASSWORD>",
        "LOCAL_MULTISITE": "<YOUR_LOCAL_MULTISITE>",
        "LOCAL_DEFAULT_BLOG_ID": "<YOUR_LOCAL_DEFAULT_BLOG_ID>",
        "LOCAL_DEFAULT_SITE_ID": "<YOUR_LOCAL_DEFAULT_SITE_ID>",
        "LOCAL_SSL_ENABLED": "<YOUR_LOCAL_SSL_ENABLED>",
        "LOCAL_SSL_CA_FILEPATH": "<YOUR_LOCAL_SSL_CA_FILEPATH>",
        "LOCAL_SSL_CERT_FILEPATH": "<YOUR_LOCAL_SSL_CERT_FILEPATH>",
        "LOCAL_SSL_KEY_FILEPATH": "<YOUR_LOCAL_SSL_KEY_FILEPATH>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "wp-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@rnaga/wp-mcp",
        "-y",
        "local",
        "start"
      ],
      "env": {
        "LOCAL_USERNAME": "<YOUR_LOCAL_USERNAME>",
        "WP_DB_HOST": "<YOUR_WP_DB_HOST>",
        "WP_DB_PORT": "<YOUR_WP_DB_PORT>",
        "WP_DB_NAME": "<YOUR_WP_DB_NAME>",
        "WP_DB_USER": "<YOUR_WP_DB_USER>",
        "WP_DB_PASSWORD": "<YOUR_WP_DB_PASSWORD>",
        "LOCAL_MULTISITE": "<YOUR_LOCAL_MULTISITE>",
        "LOCAL_DEFAULT_BLOG_ID": "<YOUR_LOCAL_DEFAULT_BLOG_ID>",
        "LOCAL_DEFAULT_SITE_ID": "<YOUR_LOCAL_DEFAULT_SITE_ID>",
        "LOCAL_SSL_ENABLED": "<YOUR_LOCAL_SSL_ENABLED>",
        "LOCAL_SSL_CA_FILEPATH": "<YOUR_LOCAL_SSL_CA_FILEPATH>",
        "LOCAL_SSL_CERT_FILEPATH": "<YOUR_LOCAL_SSL_CERT_FILEPATH>",
        "LOCAL_SSL_KEY_FILEPATH": "<YOUR_LOCAL_SSL_KEY_FILEPATH>"
      }
    }
  }
}

Claude Code

claude mcp add wp-mcp --env LOCAL_USERNAME=<YOUR_LOCAL_USERNAME> --env WP_DB_HOST=<YOUR_WP_DB_HOST> --env WP_DB_PORT=<YOUR_WP_DB_PORT> --env WP_DB_NAME=<YOUR_WP_DB_NAME> --env WP_DB_USER=<YOUR_WP_DB_USER> --env WP_DB_PASSWORD=<YOUR_WP_DB_PASSWORD> --env LOCAL_MULTISITE=<YOUR_LOCAL_MULTISITE> --env LOCAL_DEFAULT_BLOG_ID=<YOUR_LOCAL_DEFAULT_BLOG_ID> --env LOCAL_DEFAULT_SITE_ID=<YOUR_LOCAL_DEFAULT_SITE_ID> --env LOCAL_SSL_ENABLED=<YOUR_LOCAL_SSL_ENABLED> --env LOCAL_SSL_CA_FILEPATH=<YOUR_LOCAL_SSL_CA_FILEPATH> --env LOCAL_SSL_CERT_FILEPATH=<YOUR_LOCAL_SSL_CERT_FILEPATH> --env LOCAL_SSL_KEY_FILEPATH=<YOUR_LOCAL_SSL_KEY_FILEPATH> -- npx -y @rnaga/wp-mcp -y local start