WordPress MCP Server

MCP (Model Context Protocol) server for WordPress REST API. Manage posts, pages, media, comments, categories, tags, and users through 20 tools. Secure and optimized edition.

Works with Claude Desktop, Cursor, VS Code, and any MCP client.

---

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@alexgenovese/wordpress-mcp"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-application-password"
      }
    }
  }
}

Cursor / VS Code

Add to MCP settings:

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@alexgenovese/wordpress-mcp"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-application-password"
      }
    }
  }
}

HTTP Mode (Streamable HTTP)

For remote deployment or shared access:

WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npx @alexgenovese/wordpress-mcp --http

Server starts on port 3000 (configurable via PORT env var). MCP endpoint: http://localhost:3000/mcp

---

Configuration

Environment Variable	Required	Description
WORDPRESS_URL	Yes	WordPress site URL (e.g. https://your-site.com)
WORDPRESS_USERNAME	Yes	WordPress username
WORDPRESS_APP_PASSWORD	Yes	Application Password (see below)
PORT	No	Port for HTTP server (default: 3000, only used with --http)

How to Create an Application Password

1. Go to your WordPress Admin → Users → Profile
2. Scroll down to Application Passwords
3. Enter a name (e.g. "MCP Server") and click Add New Application Password
4. Copy the generated password

Important: WordPress displays the password with spaces for readability (e.g. cUAn CKZ1 u5DN). The server automatically removes spaces — you can paste it as-is.

---

All Tools (20 tools)

Posts (5 tools)

Tool	Description
wp_list_posts	List posts with filters (status, search, per_page)
wp_get_post	Get single post with full content
wp_create_post	Create post (title, content, status, categories, tags)
wp_update_post	Update post fields
wp_delete_post	Delete post (moves to trash)

Pages (5 tools)

Tool	Description
wp_list_pages	List pages with status filter
wp_get_page	Get single page with full content
wp_create_page	Create page (title, content, status, parent)
wp_update_page	Update page fields
wp_delete_page	Delete page

Media (2 tools)

Tool	Description
wp_list_media	List media files with type filter
wp_delete_media	Permanently delete media file

Comments (4 tools)

Tool	Description
wp_list_comments	List comments, filter by post
wp_create_comment	Create comment on post
wp_update_comment	Moderate comment (approve/hold/spam/trash)
wp_delete_comment	Permanently delete comment

Taxonomy (2 tools)

Tool	Description
wp_list_categories	List all categories with post counts
wp_list_tags	List all tags with post counts

Users & Site (2 tools)

Tool	Description
wp_list_users	List users with roles
wp_get_site_info	Get site name, description, URL, timezone

---

Requirements

• Node.js 18+
• WordPress with REST API enabled (enabled by default)
• Application Password (WordPress 5.6+)

---

For Developers

git clone https://github.com/alexgenovese/mcp-wordpress.git
cd mcp-wordpress
npm install
npm run build

# Run in stdio mode
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm start

# Run in dev mode (hot reload)
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm run dev

# Run in HTTP mode
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm start -- --http

---

License

MIT License - see LICENSE

Copyright (c) 2026 Alex Genovese

Links

• GitHub Repository
• WordPress REST API Handbook
• MCP Protocol
• Alex Genovese