Skip to content
Back to search

mcp-wordpress

MCP Server to manage a Wordpress CMS system.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/docdyhr/mcp-wordpress with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/docdyhr/mcp-wordpress'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/docdyhr--mcp-wordpress/badge.svg)](/listings/docdyhr--mcp-wordpress)

HTML

<a href="/listings/docdyhr--mcp-wordpress"><img src="/api/listings/docdyhr--mcp-wordpress/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://github.com/docdyhr/mcp-wordpress/wiki/setup-video)** | 📖 **[Detailed Setup Guide](docs/INSTALLATION.md)**

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 360 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. [![MCP Toplist](https://mcptoplist.com/badge/glama%2Fdocdyhr%2Fmcp-wordpress.svg)](https://mcptoplist.com/server/glama%2Fdocdyhr%2Fmcp-wordpress)
  2. <div align="right">
  3. <a href="https://railway.com?referralCode=QhjuBc">
  4. <img width="160" src="https://raw.githubusercontent.com/docdyhr/.github/main/assets/railway-corner-v2@2x.png" alt="Deploy on Railway — $20 free credits">
  5. </a>
  6. </div>
  7. # 🚀 MCP WordPress Server
  8. <div align="center">
  9. <img src="images/wordpress-mcp-logo.png" width="50%" alt="WordPress MCP Logo">
  10. **The Most Comprehensive WordPress MCP Server**
  11. Manage WordPress sites with natural language through AI tools like Claude Desktop
  12. [Quick Start](#-quick-start) • [Why This MCP Server?](#-why-this-mcp-server)
  13. [Installation Options](#-installation-options) • [Documentation](#-documentation) • [Examples](#-examples)
  14. [![CI/CD Pipeline](https://github.com/docdyhr/mcp-wordpress/actions/workflows/main-ci.yml/badge.svg)](https://github.com/docdyhr/mcp-wordpress/actions/workflows/main-ci.yml)
  15. [![GitHub Stars](https://img.shields.io/github/stars/docdyhr/mcp-wordpress?style=social)](https://github.com/docdyhr/mcp-wordpress/stargazers)
  16. [![NPM Version](https://img.shields.io/npm/v/mcp-wordpress?logo=npm&logoColor=white)](https://www.npmjs.com/package/mcp-wordpress)
  17. [![NPM Downloads](https://img.shields.io/npm/dm/mcp-wordpress?logo=npm&logoColor=white)](https://www.npmjs.com/package/mcp-wordpress)
  18. [![NPM Total Downloads](https://img.shields.io/npm/dt/mcp-wordpress?logo=npm&logoColor=white&label=total%20downloads)](https://www.npmjs.com/package/mcp-wordpress)
  19. [![Docker Pulls](https://img.shields.io/docker/pulls/docdyhr/mcp-wordpress?logo=docker&logoColor=white)](https://hub.docker.com/r/docdyhr/mcp-wordpress)
  20. [![Coverage Status](https://img.shields.io/codecov/c/github/docdyhr/mcp-wordpress?logo=codecov&logoColor=white)](https://codecov.io/gh/docdyhr/mcp-wordpress)
  21. [![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue?logo=typescript&logoColor=white)](https://github.com/docdyhr/mcp-wordpress)
  22. [![CodeQL](https://github.com/docdyhr/mcp-wordpress/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/docdyhr/mcp-wordpress/actions/workflows/codeql-analysis.yml)
  23. [![Docker](https://img.shields.io/badge/docker-ready-blue?logo=docker&logoColor=white)](https://hub.docker.com/r/docdyhr/mcp-wordpress)
  24. [![License](https://img.shields.io/badge/license-MIT-green?logo=opensource&logoColor=white)](https://github.com/docdyhr/mcp-wordpress/blob/main/LICENSE)
  25. <!-- Badges updated: 2025-12-23 -->
  26. ### 🎉 **v3.3.21** - CI-Tested on Node 22/24
  27. </div>
  28. ## 🎯 Why This MCP Server?
  29. **Transform WordPress management** from complex admin panels to simple conversations:
  30. ```text
  31. ❌ Before: Login → Admin Panel → Navigate → Click → Fill Forms → Save
  32. ✅ After: "Create a new blog post about AI trends with SEO optimization"
  33. ```
  34. **Key Advantages:**
  35. - 🏆 **Most Complete**: 73 tools vs 20-30 in alternatives
  36. - ⚡ **Fastest Setup**: 2-click Claude Desktop installation via DXT
  37. - 🔒 **CI-Tested**: 2750+ tests across Node 22/24, CodeQL + Trivy security scanning
  38. - 🎯 **TypeScript Native**: 100% type safety, best-in-class developer experience
  39. - 🌐 **Multi-Site**: Manage up to 50 WordPress sites from one place
  40. ## 🚀 Quick Start
  41. Get up and running in **under 5 minutes**:
  42. ### Prerequisites
  43. - **WordPress**: Version 5.6+ with REST API enabled
  44. - **Claude Desktop**: Latest version installed
  45. - **Application Password**: Generated from WordPress admin panel
  46. ### 3-Step Setup
  47. **1️⃣ Generate WordPress Application Password**
  48. ```text
  49. WordPress Admin → Users → Profile → Application Passwords → Add New
  50. ```
  51. **2️⃣ Install MCP Server (Choose One)**
  52. **Option A: DXT Extension (Easiest)**
  53. ```bash
  54. # Download and install in Claude Desktop
  55. curl -L https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt -o mcp-wordpress.dxt
  56. # Then: Claude Desktop → Extensions → Install → Select DXT file
  57. ```
  58. **Option B: NPM Global Install**
  59. ```bash
  60. npm install -g mcp-wordpress
  61. ```
  62. **3️⃣ Test Your Connection**
  63. ```text
  64. In Claude: "Test my WordPress connection"
  65. Response: "✅ Authentication successful! Connected to: Your Site Name"
  66. ```
  67. 📺 **[Watch 2-minute Setup Video](https://github.com/docdyhr/mcp-wordpress/wiki/setup-video)** | 📖
  68. **[Detailed Setup Guide](docs/INSTALLATION.md)**
  69. ## ⚡ Installation Options
  70. ### 🏆 Recommended: Claude Desktop Extension (DXT)
  71. **Easiest installation - just 2 clicks!**
  72. 1. **Download**:
  73. [`mcp-wordpress.dxt`](https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt) (3.4MB)
  74. 2. **Install**: Claude Desktop → Extensions → Install → Select DXT file
  75. 3. **Configure**: Enter your WordPress site URL and credentials
  76. ✅ **Zero command line required** ✅ **Easy updates** ✅ **Built-in security**
  77. **[📖 Complete DXT Setup Guide →](docs/integrations/claude-desktop.md)**
  78. ### 🚀 Alternative: NPX (Power Users)
  79. ```bash
  80. # Run directly - always latest version
  81. npx -y mcp-wordpress
  82. # Interactive setup wizard
  83. npm run setup
  84. ```
  85. ### 🔧 Other Options
  86. - 💻 **[NPM Setup](docs/user-guides/NPM_SETUP.md)** - Local development
  87. - 🐳 **[Docker Setup](docs/user-guides/DOCKER_SETUP.md)** - Production deployment
  88. - 🔧 **[Manual Build](docs/developer/BUILD_SYSTEM.md)** - Custom builds
  89. ## 📋 Configuration
  90. **Single Site (.env)**
  91. ```bash
  92. WORDPRESS_SITE_URL=https://myblog.com
  93. WORDPRESS_USERNAME=admin
  94. WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
  95. ```
  96. **Claude Desktop Config**
  97. ```json
  98. {
  99. "mcpServers": {
  100. "mcp-wordpress": {
  101. "command": "npx",
  102. "args": ["-y", "mcp-wordpress"],
  103. "env": {
  104. "WORDPRESS_SITE_URL": "https://myblog.com",
  105. "WORDPRESS_USERNAME": "admin",
  106. "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
  107. }
  108. }
  109. }
  110. }
  111. ```
  112. 📖 **[Complete Configuration Guide](docs/CONFIGURATION.md)** — multi-site, JWT, Docker, production environments
  113. ## 🔐 Authentication
  114. WordPress Application Passwords are recommended:
  115. 1. **WordPress Admin** → **Users** → **Profile** → **Application Passwords** → **Add New**
  116. 2. Copy the generated password into your config
  117. Alternative methods: JWT, Basic Auth, API Key — see
  118. **[Authentication Configuration](docs/CONFIGURATION.md#authentication-configuration)**
  119. ## 🌟 What Makes This Special
  120. | Feature | This Server | Competition |
  121. | -------------------------- | ---------------------------------- | --------------- |
  122. | **Tools Available** | 73 tools | 20-30 tools |
  123. | **Claude Desktop DXT** | ✅ 2-click install | ❌ Manual setup |
  124. | **Multi-Site Support** | ✅ Up to 50 sites | ❌ Single site |
  125. | **TypeScript** | ✅ 100% TypeScript, strict mode | ⚠️ Partial/None |
  126. | **Performance Monitoring** | ✅ Real-time analytics | ❌ Basic only |
  127. | **Test Coverage** | ✅ 2750+ tests, ~76% line coverage | ⚠️ Limited |
  128. | **Security Scanning** | ✅ CodeQL + Trivy in CI | ⚠️ Unknown |
  129. ## 📋 Available Tools (73 Tools)
  130. ### Content Management
  131. - **📝 Posts** (6 tools) - Create, edit, delete, and list posts and custom post types
  132. - **📄 Pages** (6 tools) - Manage static pages and revisions
  133. - **🖼️ Media** (5 tools) - Upload, manage media library and files
  134. - **🔍 SEO** (11 tools) - Content analysis, metadata, schema markup, SERP tracking, keyword research
  135. ### User & Community
  136. - **👥 Users** (6 tools) - User management and profiles
  137. - **💬 Comments** (7 tools) - Comment moderation and management
  138. - **🏷️ Taxonomies** (10 tools) - Categories and tags management
  139. ### Site Management
  140. - **⚙️ Site Settings** (6 tools) - Site configuration and statistics
  141. - **🔐 Authentication** (3 tools) - Auth testing and management
  142. - **⚡ Cache Management** (4 tools) - Performance caching control
  143. - **📊 Performance Monitoring** (6 tools) - Real-time metrics and optimization
  144. - **🛠️ System** (3 tools) - Version, plugin, and theme inspection
  145. 📖 **[Complete Tool Documentation](docs/api/README.md)** | **[Live API Reference](docs/developer/API_REFERENCE.md)**
  146. ## 🤖 Examples
  147. ```text
  148. 💬 "Create a new blog post about AI trends with SEO optimization"
  149. 💬 "Check my WordPress site performance and provide optimization recommendations"
  150. 💬 "Find all draft posts older than 30 days and provide a summary"
  151. 💬 "Batch update all client sites with the new privacy policy footer"
  152. 💬 "List all posts from my client-blog site"
  153. ```
  154. 📖 **[More Examples](docs/examples/)** | **[Real-World Workflows](docs/examples/use-case-workflows.md)**
  155. ## 🧪 Testing & Security
  156. ```bash
  157. npm test # Full test suite (2750/2750 passing, 94 files)
  158. npm run test:security # Security tests (371/371 passing)
  159. npm run health # System health check
  160. ```
  161. 📖 **[Security Documentation](docs/SECURITY.md)** — OWASP coverage, penetration testing, compliance
  162. ## 🛠️ Troubleshooting
  163. ```bash
  164. npm run health # System check
  165. DEBUG=true npm run dev # Debug logging
  166. npm run fix:rest-auth # Fix WordPress 401 errors
  167. ```
  168. | Error | Solution |
  169. | -------------------- | ---------------------------------- |
  170. | `401 Unauthorized` | Regenerate application password |
  171. | `403 Forbidden` | Check user role (Editor+ required) |
  172. | `404 Not Found` | Verify `WORDPRESS_SITE_URL` |
  173. | `Connection Timeout` | Check WordPress REST API access |
  174. 📖 **[Full Troubleshooting Guide](docs/TROUBLESHOOTING.md)**
  175. ## 📚 Documentation
  176. ### Getting Started
  177. - **[Quick Start Guide](#-quick-start)** - Get running in 5 minutes
  178. - **[Installation Guide](docs/INSTALLATION.md)** - Detailed setup instructions
  179. - **[Configuration Guide](docs/CONFIGURATION.md)** - All configuration options
  180. - **[Authentication Setup](docs/SECURITY.md#authentication)** - WordPress auth methods
  181. ### User Guides
  182. - **[Basic Usage](docs/examples/single-site-setup.md)** - Common tasks and workflows
  183. - **[Advanced Workflows](docs/examples/use-case-workflows.md)** - Complex automation
  184. - **[Multi-Site Management](docs/examples/multi-site-setup.md)** - Managing multiple sites
  185. - **[Troubleshooting](docs/TROUBLESHOOTING.md)** - Common issues and solutions
  186. ### Integration Guides
  187. - **[Claude Desktop](docs/integrations/claude-desktop.md)** - Complete Claude integration
  188. - **[VS Code](docs/integrations/vs-code.md)** - VS Code extension setup
  189. - **[Cline](docs/integrations/cline.md)** - Cline AI assistant integration
  190. - **[Developer Guide](docs/developer/README.md)** - Build your own MCP client
  191. ### Developer Documentation
  192. - **[API Reference](docs/developer/API_REFERENCE.md)** - Complete tool documentation
  193. - **[Architecture](docs/ARCHITECTURE.md)** - System design and decisions
  194. - **[Contributing](CONTRIBUTING.md)** - Development guidelines
  195. - **[Build System](docs/developer/BUILD_SYSTEM.md)** - Build and release
  196. ### Deployment & Operations
  197. - **[Docker Deployment](docs/DOCKER.md)** - Container deployment
  198. - **[Publishing Troubleshooting](docs/PUBLISHING-TROUBLESHOOTING.md)** - Fix publishing issues
  199. - **[Security Best Practices](docs/SECURITY.md)** - Production security
  200. - **[Caching](docs/CACHING.md)** - Performance and caching guide
  201. ## 🔧 Requirements
  202. - **WordPress 5.0+** with REST API enabled
  203. - **HTTPS recommended** for production
  204. - **Application Passwords enabled** (WordPress 5.6+)
  205. | Role | Access |
  206. | ----------------- | ----------------------------- |
  207. | **Administrator** | Full access to all functions |
  208. | **Editor** | Posts, pages, comments, media |
  209. | **Author** | Own posts and media |
  210. | **Contributor** | Own posts (drafts only) |
  211. | **Subscriber** | Read only |
  212. ## 🚀 Next Steps
  213. **Ready to transform your WordPress management?**
  214. 1. **🏆
  215. [Download DXT Extension](https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt)** -
  216. Easiest setup (2 minutes)
  217. 2. **⚡ [Try NPX Method](docs/user-guides/NPX_SETUP.md)** - Power user setup (5 minutes)
  218. 3. **📚 [Explore All Tools](docs/api/README.md)** - See what's possible
  219. 4. **💬 [Join Discussions](https://github.com/docdyhr/mcp-wordpress/discussions)** - Get help and share ideas
  220. ---
  221. ## 🔗 Similar Projects
  222. - **[Automattic WordPress MCP](https://github.com/Automattic/wordpress-mcp)** - Official WordPress MCP server by
  223. Automattic
  224. ---
  225. ## 📋 Changelog
  226. ### v3.3.21 (July 2026)
  227. - **🔒 Security Hardening** - SSRF denylist, HTTPS enforcement, logger redaction, dependency floor updates
  228. - **🐳 Docker Release Reliability** - Bounded publish-job timeouts and corrected retry-on-hang logic
  229. - **📚 DOX Documentation** - Hierarchical AGENTS.md contract tree for per-directory work guidance
  230. See [CHANGELOG.md](./CHANGELOG.md) for the complete, release-by-release history.
  231. ### v3.3.14 (June 2026)
  232. - **🔒 Security Updates** - Patch moderate Hono vulnerabilities, update allowlisted npm-bundled advisories
  233. - **🧪 CI** - Smoke-test improvements and Node 24 validation
  234. ### v3.x Series (2025–2026)
  235. - **🏗️ Modular Architecture** - Domain-specific operation modules and composition pattern
  236. - **🔄 Fault Tolerance** - Circuit breaker pattern with automatic recovery
  237. - **📊 2200+ Tests** - Comprehensive test suite across security, cache, server, client, config, utils, tools, and
  238. performance
  239. - **⚡ Caching Layer** - `CachedWordPressClient` with configurable TTL; 50–70% faster repeat requests
  240. - **🌐 Multi-Site** - Up to 50 WordPress sites from one configuration file
  241. - **🔐 4 Auth Methods** - App Passwords (recommended), JWT, Basic, API Key
  242. - **🐳 Docker & DXT** - One-click Claude Desktop extension and Docker Hub image
  243. For the full history see [CHANGELOG.md](CHANGELOG.md).
  244. ---
  245. ## 🙏 Acknowledgments
  246. Special thanks to **[Stephan Ferraro](https://github.com/ferraro)** for the upstream project that inspired this
  247. implementation.
  248. ---
  249. <div align="center">
  250. **⭐ Found this helpful? [Give us a star on GitHub!](https://github.com/docdyhr/mcp-wordpress) ⭐**
  251. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.