Mcp Wordpress Setup

WordPress MCP Server Setup for Claude Code

> Built by Artur Ferreira @ The GEO Lab · 𝕏 @TheGEO\Lab · LinkedIn · Reddit

[](https://github.com/arturseo-geo/mcp-wordpress-setup/blob/main/CONTRIBUTING.md)

Step-by-step guide to configure the mcp-wordpress MCP server with Claude Code, giving Claude full access to manage your WordPress site through the REST API — posts, pages, media, SEO, caching, and more.

Includes a critical workaround for a bug in mcp-wordpress v3.1.13 where the published bin entry point fails to start.

Who This Is For

• Claude Code users who want to manage WordPress from their CLI
• WordPress developers setting up MCP for the first time
• Anyone who tried mcp-wordpress and got a silent failure (the bin bug)

What This Covers

• ✅ Prerequisites — Node.js version requirements, Claude Code installation
• ✅ Application Password creation — step-by-step WordPress admin walkthrough
• ✅ .mcp.json configuration — verified working config with correct paths
• ✅ Critical bin bug workaround — why mcp-wordpress binary fails silently in v3.1.13 and how to point to dist/index.js instead
• ✅ Path discovery — commands to find your Node.js binary and mcp-wordpress install location
• ✅ Verification — how to confirm the MCP server is running
• ✅ Production-tested — patterns used in production at thegeolab.net

Quick Start

# 1. Install mcp-wordpress
npm install -g mcp-wordpress

# 2. Create Application Password in WordPress admin
#    Users > Profile > Application Passwords

# 3. Add to ~/.mcp.json (IMPORTANT: use dist/index.js, not the bin script)

{
  "mcpServers": {
    "wordpress": {
      "command": "/path/to/node",
      "args": ["/path/to/node_modules/mcp-wordpress/dist/index.js"],
      "env": {
        "WORDPRESS_SITE_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

# 4. Find your paths
which node                                          # Node binary
echo "$(npm root -g)/mcp-wordpress/dist/index.js"  # mcp-wordpress entry point

The Bin Bug (v3.1.13)

The published binary (bin/mcp-wordpress.js) contains an isMainModule check that fails when Node invokes the file through the bin symlink. As a result, calling mcp-wordpress directly will silently do nothing — main() never executes.

Fix: Point your MCP config to dist/index.js instead of the binary. This is reflected in the config above.

Related Repos

• wordpress-skill — Comprehensive WordPress skill for Claude Code
• claude-code-skills — Full collection of 12 skills

---

Built and maintained by Artur Ferreira · thegeolab.net · [MIT License](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: arturseo-geo
• Source: arturseo-geo/mcp-wordpress-setup
• License: MIT
• Homepage: https://thegeolab.net

Install and usage instructions live in the source repository linked above.