Manage WordPress sites through natural language to create posts, manage media, handle SEO, and monitor site performance.
Also known as docdyhr/mcp-wordpress
- Stars
- 114
- Tools
- โ
- Downloads, 30 days
- โ
- Latest version
- โ
- Last commit
- Nov 10, 2026
- License
- MIT
What is WordPress MCP?
WordPress manages WordPress sites through natural language to create posts, manage media, handle SEO, and monitor site performance.
Summary generated from the project's README
About WordPress MCP server
Managing WordPress websites through natural language conversations is what this server enables for developers and site administrators. By connecting to an AI client like Claude Desktop, users can bypass complex admin panels to perform tasks such as creating blog posts, managing media libraries, and handling SEO metadata. The server supports up to 50 different WordPress sites from a single installation, making it suitable for agencies managing multiple client properties.
Setup requires a WordPress site running version 5.6 or higher with the REST API enabled. Users must generate an Application Password from their WordPress user profile to authenticate. Installation can be done via a two-click DXT extension for Claude Desktop, through an NPM global install, or using Docker for production environments. The server provides 73 distinct tools covering content, users, taxonomies, and site settings, offering significantly more functionality than standard alternatives.
What you can do with it
- 1Automated Content CreationAsk the AI to draft and publish a new blog post including specific SEO optimizations.
- 2Site Performance AuditingRequest a summary of your website's real-time metrics and suggestions for improvement.
- 3Bulk Content ManagementIdentify and summarize old draft posts that have been sitting unused for a long time.
- 4Multi-Site UpdatesApply specific changes like a new footer across all of your managed client websites at once.
Written from the project's README. Every use case is checked against a quote from it.
How to install WordPress MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall WordPress MCP in Claude Code
$ claude mcp add mcp-wordpress -- npx -y mcp-wordpressInstall WordPress MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-wordpress": {
"command": "npx",
"args": [
"-y",
"mcp-wordpress"
]
}
}
}Install WordPress MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-wordpress": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-wordpress"
]
}
}
}Install WordPress MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-wordpress","type":"stdio","command":"npx","args":["-y","mcp-wordpress"]}'Install WordPress MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-wordpress": {
"command": "npx",
"args": [
"-y",
"mcp-wordpress"
]
}
}
}Install WordPress MCP in Codex
$ codex mcp add mcp-wordpress -- npx -y mcp-wordpressInstall WordPress MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-wordpress] command = "npx" args = ["-y", "mcp-wordpress"]
Install WordPress MCP in Gemini CLI
$ gemini mcp add -s user mcp-wordpress npx -- -y mcp-wordpressInstall WordPress MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-wordpress": {
"command": "npx",
"args": [
"-y",
"mcp-wordpress"
]
}
}
}Configuration
WORDPRESS_APP_PASSWORDWORDPRESS_SITE_URLWORDPRESS_USERNAME
| Name | Description | |
|---|---|---|
| WORDPRESS_APP_PASSWORD | โ | |
| WORDPRESS_SITE_URL | โ | |
| WORDPRESS_USERNAME | โ |
Automated checks
Ran Nov 12, 2026Full report โPassed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHub
๐ MCP WordPress Server
The Most Comprehensive WordPress MCP Server
Manage WordPress sites with natural language through AI tools like Claude Desktop
Quick Start โข Why This MCP Server? Installation Options โข Documentation โข Examples
๐ v3.3.21 - CI-Tested on Node 22/24
๐ฏ Why This MCP Server?
Transform WordPress management from complex admin panels to simple conversations:
โ Before: Login โ Admin Panel โ Navigate โ Click โ Fill Forms โ Save
โ
After: "Create a new blog post about AI trends with SEO optimization"
Key Advantages:
- ๐ Most Complete: 73 tools vs 20-30 in alternatives
- โก Fastest Setup: 2-click Claude Desktop installation via DXT
- ๐ CI-Tested: 2750+ tests across Node 22/24, CodeQL + Trivy security scanning
- ๐ฏ TypeScript Native: 100% type safety, best-in-class developer experience
- ๐ Multi-Site: Manage up to 50 WordPress sites from one place
๐ Quick Start
Get up and running in under 5 minutes:
Prerequisites
- WordPress: Version 5.6+ with REST API enabled
- Claude Desktop: Latest version installed
- Application Password: Generated from WordPress admin panel
3-Step Setup
1๏ธโฃ Generate WordPress Application Password
WordPress Admin โ Users โ Profile โ Application Passwords โ Add New
2๏ธโฃ Install MCP Server (Choose One)
Option A: DXT Extension (Easiest)
# Download and install in Claude Desktop
curl -L https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt -o mcp-wordpress.dxt
# Then: Claude Desktop โ Extensions โ Install โ Select DXT file
Option B: NPM Global Install
npm install -g mcp-wordpress
3๏ธโฃ Test Your Connection
In Claude: "Test my WordPress connection"
Response: "โ
Authentication successful! Connected to: Your Site Name"
๐บ Watch 2-minute Setup Video | ๐ Detailed Setup Guide
โก Installation Options
๐ Recommended: Claude Desktop Extension (DXT)
Easiest installation - just 2 clicks!
- Download:
mcp-wordpress.dxt(3.4MB) - Install: Claude Desktop โ Extensions โ Install โ Select DXT file
- Configure: Enter your WordPress site URL and credentials
โ Zero command line required โ Easy updates โ Built-in security
๐ Complete DXT Setup Guide โ
๐ Alternative: NPX (Power Users)
# Run directly - always latest version
npx -y mcp-wordpress
# Interactive setup wizard
npm run setup
๐ง Other Options
- ๐ป NPM Setup - Local development
- ๐ณ Docker Setup - Production deployment
- ๐ง Manual Build - Custom builds
๐ Configuration
Single Site (.env)
WORDPRESS_SITE_URL=https://myblog.com
WORDPRESS_USERNAME=admin
WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
Claude Desktop Config
{
"mcpServers": {
"mcp-wordpress": {
"command": "npx",
"args": ["-y", "mcp-wordpress"],
"env": {
"WORDPRESS_SITE_URL": "https://myblog.com",
"WORDPRESS_USERNAME": "admin",
"WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
}
}
}
}
๐ Complete Configuration Guide โ multi-site, JWT, Docker, production environments
๐ Authentication
WordPress Application Passwords are recommended:
- WordPress Admin โ Users โ Profile โ Application Passwords โ Add New
- Copy the generated password into your config
Alternative methods: JWT, Basic Auth, API Key โ see Authentication Configuration
๐ What Makes This Special
| Feature | This Server | Competition |
|---|---|---|
| Tools Available | 73 tools | 20-30 tools |
| Claude Desktop DXT | โ 2-click install | โ Manual setup |
| Multi-Site Support | โ Up to 50 sites | โ Single site |
| TypeScript | โ 100% TypeScript, strict mode | โ ๏ธ Partial/None |
| Performance Monitoring | โ Real-time analytics | โ Basic only |
| Test Coverage | โ 2750+ tests, ~76% line coverage | โ ๏ธ Limited |
| Security Scanning | โ CodeQL + Trivy in CI | โ ๏ธ Unknown |
๐ Available Tools (73 Tools)
Content Management
- ๐ Posts (6 tools) - Create, edit, delete, and list posts and custom post types
- ๐ Pages (6 tools) - Manage static pages and revisions
- ๐ผ๏ธ Media (5 tools) - Upload, manage media library and files
- ๐ SEO (11 tools) - Content analysis, metadata, schema markup, SERP tracking, keyword research
User & Community
- ๐ฅ Users (6 tools) - User management and profiles
- ๐ฌ Comments (7 tools) - Comment moderation and management
- ๐ท๏ธ Taxonomies (10 tools) - Categories and tags management
Site Management
- โ๏ธ Site Settings (6 tools) - Site configuration and statistics
- ๐ Authentication (3 tools) - Auth testing and management
- โก Cache Management (4 tools) - Performance caching control
- ๐ Performance Monitoring (6 tools) - Real-time metrics and optimization
- ๐ ๏ธ System (3 tools) - Version, plugin, and theme inspection
๐ Complete Tool Documentation | Live API Reference
๐ค Examples
๐ฌ "Create a new blog post about AI trends with SEO optimization"
๐ฌ "Check my WordPress site performance and provide optimization recommendations"
๐ฌ "Find all draft posts older than 30 days and provide a summary"
๐ฌ "Batch update all client sites with the new privacy policy footer"
๐ฌ "List all posts from my client-blog site"
๐ More Examples | Real-World Workflows
๐งช Testing & Security
npm test # Full test suite (2750/2750 passing, 94 files)
npm run test:security # Security tests (371/371 passing)
npm run health # System health check
๐ Security Documentation โ OWASP coverage, penetration testing, compliance
๐ ๏ธ Troubleshooting
npm run health # System check
DEBUG=true npm run dev # Debug logging
npm run fix:rest-auth # Fix WordPress 401 errors
| Error | Solution |
|---|---|
401 Unauthorized |
Regenerate application password |
403 Forbidden |
Check user role (Editor+ required) |
404 Not Found |
Verify WORDPRESS_SITE_URL |
Connection Timeout |
Check WordPress REST API access |
๐ Full Troubleshooting Guide
๐ Documentation
Getting Started
- Quick Start Guide - Get running in 5 minutes
- Installation Guide - Detailed setup instructions
- Configuration Guide - All configuration options
- Authentication Setup - WordPress auth methods
User Guides
- Basic Usage - Common tasks and workflows
- Advanced Workflows - Complex automation
- Multi-Site Management - Managing multiple sites
- Troubleshooting - Common issues and solutions
Integration Guides
- Claude Desktop - Complete Claude integration
- VS Code - VS Code extension setup
- Cline - Cline AI assistant integration
- Developer Guide - Build your own MCP client
Developer Documentation
- API Reference - Complete tool documentation
- Architecture - System design and decisions
- Contributing - Development guidelines
- Build System - Build and release
Deployment & Operations
- Docker Deployment - Container deployment
- Publishing Troubleshooting - Fix publishing issues
- Security Best Practices - Production security
- Caching - Performance and caching guide
๐ง Requirements
- WordPress 5.0+ with REST API enabled
- HTTPS recommended for production
- Application Passwords enabled (WordPress 5.6+)
| Role | Access |
|---|---|
| Administrator | Full access to all functions |
| Editor | Posts, pages, comments, media |
| Author | Own posts and media |
| Contributor | Own posts (drafts only) |
| Subscriber | Read only |
๐ Next Steps
Ready to transform your WordPress management?
- ๐ Download DXT Extension - Easiest setup (2 minutes)
- โก Try NPX Method - Power user setup (5 minutes)
- ๐ Explore All Tools - See what's possible
- ๐ฌ Join Discussions - Get help and share ideas
๐ Similar Projects
- Automattic WordPress MCP - Official WordPress MCP server by Automattic
๐ Changelog
v3.3.21 (July 2026)
- ๐ Security Hardening - SSRF denylist, HTTPS enforcement, logger redaction, dependency floor updates
- ๐ณ Docker Release Reliability - Bounded publish-job timeouts and corrected retry-on-hang logic
- ๐ DOX Documentation - Hierarchical AGENTS.md contract tree for per-directory work guidance
See CHANGELOG.md for the complete, release-by-release history.
v3.3.14 (June 2026)
- ๐ Security Updates - Patch moderate Hono vulnerabilities, update allowlisted npm-bundled advisories
- ๐งช CI - Smoke-test improvements and Node 24 validation
v3.x Series (2025โ2026)
- ๐๏ธ Modular Architecture - Domain-specific operation modules and composition pattern
- ๐ Fault Tolerance - Circuit breaker pattern with automatic recovery
- ๐ 2200+ Tests - Comprehensive test suite across security, cache, server, client, config, utils, tools, and performance
- โก Caching Layer -
CachedWordPressClientwith configurable TTL; 50โ70% faster repeat requests - ๐ Multi-Site - Up to 50 WordPress sites from one configuration file
- ๐ 4 Auth Methods - App Passwords (recommended), JWT, Basic, API Key
- ๐ณ Docker & DXT - One-click Claude Desktop extension and Docker Hub image
For the full history see CHANGELOG.md.
๐ Acknowledgments
Special thanks to Stephan Ferraro for the upstream project that inspired this implementation.
โญ Found this helpful? Give us a star on GitHub! โญ
WordPress MCP questions
How do I add WordPress MCP to Claude Code?
Run claude mcp add mcp-wordpress -- npx -y mcp-wordpress in your terminal. Add --scope user to make it available in every project.
How do I add WordPress MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.