wordpress

WPMCP is a WordPress-focused MCP server that enables AI agents to manage a WordPress site through natural language. Once configured, you can connect Claude, Cline, or any MCP-compatible AI to the WordPress MCP server and issue high-level instructions like creating posts, managing plugins, configuring themes, handling media, and performing advanced operations such as SEO adjustments, backups, and security checks. The server exposes over 130 tools across categories such as Posts, Pages, Media, Plugins, Theme Manager, Security, Performance, WooCommerce, Custom Types, and more, allowing you to perform complex workflows via simple prompts. Start by installing the MCP client integration, then configure the WordPress endpoint in your MCP client so the AI can send commands through the WordPress MCP Server plugin interface you enable in WordPress. Typical use cases include creating and publishing content, updating themes and plugins, manipulating menus and widgets, running scheduled tasks, and performing maintenance tasks like backups and site health checks. The 130+ tools are organized into categories with concrete actions (e.g., create/update/delete posts, activate plugins, manage menus, execute shortcodes, run cron jobs, read theme files, and manage security settings).

Prerequisites:

• Node.js and npm installed on the machine that will host or proxy the MCP client integration.
• Access to a WordPress site where you can install the WordPress MCP Server Plugin.

Step-by-step:

1. Install the MCP client globally (example shown in Quick Start):

   npm i -g wpmcp@3.0.0
   

2. Start or reference the WordPress MCP Server via your MCP client by using the mcp_config (see below). The server uses npx to pull and run the wpmcp package.
3. In WordPress:
   • Install the WordPress MCP Server Plugin (wpmcp-plugin).
   • Activate the plugin via WordPress Admin → Plugins → "WordPress MCP Server Plugin".
   • Ensure required capabilities (edit_themes, edit_plugins) are granted to the MCP user or token used.
4. Add configuration to your MCP client (Claude Desktop, Cline, etc.) to point to the WordPress MCP Server:

   {
     "mcpServers": {
       "wordpress": {
         "command": "npx",
         "args": ["-y", "wpmcp@3.0.0"],
         "env": {
           "WORDPRESS_URL": "https://your-site.com",
           "WORDPRESS_USERNAME": "admin",
           "WORDPRESS_PASSWORD": "your-app-password"
         }
       }
     }
   }
   

5. After configuration, connect your MCP assistant to the server and begin issuing natural language prompts that map to the available tools. Prerequisites may include network access to the WordPress site and valid credentials for the plugin-enabled WordPress instance.

Tips and common issues: - Ensure the WordPress MCP Server Plugin is installed and activated, and that the API user has the necessary capabilities (edit_themes, edit_plugins). - Store WordPress credentials securely; avoid hard-coding passwords where possible and use environment variable management if supported by your MCP client. - If you encounter permission errors, verify file system access permissions for theme and plugin directories (/wp-content/themes, /wp-content/plugins). - The available tools cover extensive areas from content creation to theme control and security; start with simple tasks (e.g., create a post) to validate connectivity and gradually explore advanced capabilities (cron jobs, backups, plugin management). - If the AI attempts actions that require elevated privileges, ensure the user associated with WORDPRESS_USERNAME has those capabilities. - For large operations, consider running actions in sequences or using scheduling features to avoid long-running prompts that could hit timeouts.