WordPress MCP

A Model Context Protocol (MCP) server that gives AI agents full control over WordPress sites. Manage posts, pages, media, categories, tags, comments, SEO, redirects, Gutenberg blocks, reusable patterns, TablePress tables, plugins, users, and site settings — all through 46 MCP tools.

Built for Claude Code. Also compatible with the Claude Agent SDK and any MCP-capable client.

How It Works

┌─────────────┐     JSON-RPC      ┌──────────────────┐     HTTP/Auth     ┌─────────────────┐
│  Claude /    │ ──────────────▶  │  Python MCP      │ ──────────────▶  │  WordPress Site  │
│  AI Agent    │                  │  Proxy Server    │                  │  (MCP Adapter)   │
│              │ ◀──────────────  │  (server.py)     │ ◀──────────────  │  (mu-plugin)     │
└─────────────┘     MCP Tools     └──────────────────┘     JSON-RPC     └─────────────────┘
                                         │
                                    sites.json
                                  (multi-site config)

A single Python proxy handles unlimited WordPress sites. Each tool call includes a site parameter to target a specific site. Authentication uses WordPress Application Passwords (built into WP 5.6+).

Features

| Category | Tools | Capabilities | |----------|-------|-------------| | Posts & Pages | 9 tools | CRUD, bulk status change, revisions, search & replace | | Categories & Tags | 8 tools | CRUD with Rank Math SEO support | | Media | 4 tools | Upload from URL, browse library, update metadata, delete | | Comments | 3 tools | List, moderate (approve/spam/trash), reply, delete | | Rank Math SEO | — | Full SEO metadata on posts and categories (title, description, focus keyword, Open Graph, Twitter, schema, robots) | | Redirections | 4 tools | Rank Math redirect CRUD (301/302/307/410/451) | | Gutenberg Blocks | 1 tool | Discover all registered block types with attribute schemas | | Synced Patterns | 5 tools | Create, read, update, delete reusable blocks | | TablePress | 5 tools | Full table CRUD with display options and visibility | | Plugins | 2 tools | List installed plugins, activate/deactivate | | Users | 1 tool | List users with role filtering | | Settings | 3 tools | Read/write options, flush caches, get site info | | Utility | 1 tool | List all configured sites |

Total: 46 tools covering the full WordPress management surface.

Quick Start

1. Install the WordPress adapter

# Build PHP dependencies locally
cd wordpress/
composer install

# Upload vendor/ and load-mcp-adapter.php to your WordPress server
# See SETUP.md for detailed instructions

2. Configure the proxy

# Copy the example config
cp sites.json.example sites.json

# Edit with your site details

{
  "myblog": {
    "url": "https://yourdomain.com/wp-json/mcp/mcp-adapter-default-server",
    "username": "YourAdmin",
    "password": "xxxx xxxx xxxx xxxx xxxx xxxx"
  }
}

3. Connect to Claude

Claude Code — add to ~/.claude.json (or ask your Claude Code agent to set it up for you):

{
  "mcpServers": {
    "wordpress": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--with", "fastmcp",
        "--with", "httpx",
        "python",
        "/path/to/wordpress-mcp/server.py"
      ]
    }
  }
}

Then install the skill for tool documentation:

npx skills add 5unnykum4r/wordpress-mcp

Or manually symlink:

ln -s /path/to/wordpress-mcp/skill/wordpress-mcp ~/.claude/skills/wordpress-mcp

See the full setup guide for detailed instructions, troubleshooting, and usage examples.

Tool Reference

All tools require site as the first parameter.