WordPress Headless MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add wp-headless-mcp -e 'WP_URL=<WP_URL>' -- npx -y wp-headless-mcp

{
  "mcpServers": {
    "wp-headless-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wp-headless-mcp"
      ],
      "env": {
        "WP_URL": "<WP_URL>"
      }
    }
  }
}

[mcp_servers.wp-headless-mcp]
command = "npx"
args = ["-y", "wp-headless-mcp"]
env = { WP_URL = "<WP_URL>" }

{
  "mcpServers": {
    "wp-headless-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wp-headless-mcp"
      ],
      "env": {
        "WP_URL": "<WP_URL>"
      }
    }
  }
}

{
  "servers": {
    "wp-headless-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wp-headless-mcp"
      ],
      "env": {
        "WP_URL": "<WP_URL>"
      }
    }
  }
}

Put your own value in place of <WP_URL> (Base URL of the WordPress site, without a trailing slash). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: MCP_PROFILE (Tool profile: public (read published content), editor (adds draft-only editing), or dev (adds developer tools)), WP_USER (WordPress user for the Application Password (editor and dev profiles)), WP_APP_PASSWORD (WordPress Application Password (editor and dev profiles)), WP_CACHE_TTL (Seconds to cache GET requests; 0 turns caching off), ACF_JSON_PATH (Absolute path to the theme's acf-json folder, for ACF labels, schemas, and TypeScript types), MCP_CPTS (Custom post type tools: auto, none, or a JSON array of {postType, singular, plural}).