WordPress MCP Server

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with WordPress sites through a standardized interface.

WordPress MCP Server provides a secure bridge between AI assistants and WordPress installations, allowing for content management, site administration, and plugin/theme operations through natural language interactions. Built on the Model Context Protocol standard, it offers a comprehensive set of tools for WordPress automation.

- Content Management: Create, read, update, and delete posts, pages, and custom post types
- Media Handling: Upload and manage media files with automatic optimization
- User Management: Handle user operations and permissions
- Plugin & Theme Control: Install, activate, deactivate, and manage plugins/themes
- Site Configuration: Manage WordPress settings and configurations
- Custom Post Types: Full support for custom post types and taxonomies
- SEO Integration: Built-in support for popular SEO plugins
- Security: OAuth2 authentication and secure API communications
- Batch Operations: Efficient bulk actions for content and media
- Real-time Updates: Live site status and health monitoring

- Node.js 16.0 or higher
- npm or yarn package manager
- WordPress 5.0 or higher with REST API enabled
- Valid WordPress admin credentials or application passwords
- Claude Code or any MCP-compatible client

# Clone the repository git clone https://github.com/yourusername/wordpress-mcp-server.git cd wordpress-mcp-server # Install dependencies npm install # Build the project npm run build # Configure your WordPress connection npm run configure

npm install -g wordpress-mcp-server wordpress-mcp configure

- Or manually createwordpress-config.json:

{ "sites": [ { "name": "my-wordpress-site", "url": "https://example.com", "username": "admin", "password": "your-application-password", "authMethod": "basic" } ], "defaultSite": "my-wordpress-site" }

- Go to WordPress Admin → Users → Your Profile
- Scroll to "Application Passwords"
- Enter a name and click "Add New Application Password"
- Copy the generated password to your config

- Requires HTTP Basic Auth plugin
- Less secure, use only for development

- Most secure option
- Requires OAuth2 plugin setup
- SeeOAuth2 Setup Guide

{ "mcpServers": { "wordpress": { "command": "npx", "args": ["wordpress-mcp-server", "start"] } } }

"Create a new blog post about AI trends with featured image" "Update the homepage content" "Install and activate Yoast SEO plugin" "Bulk upload images from folder"

const { WordPressMCP } = require('wordpress-mcp-server'); const mcp = new WordPressMCP({ site: 'my-wordpress-site' }); // Create a post await mcp.tools.createPost({ title: 'Hello World', content: 'This is my first post!', status: 'publish' });

- wp_create_post- Create posts, pages, or custom post types
- wp_update_post- Update existing content
- wp_get_post- Retrieve post details
- wp_delete_post- Delete content
- wp_list_posts- List and filter content

- wp_upload_media- Upload images, videos, documents
- wp_get_media- Retrieve media information
- wp_delete_media- Remove media files
- wp_optimize_images- Bulk image optimization

- wp_get_site_info- Site details and health
- wp_update_settings- Modify site settings
- wp_clear_cache- Clear various caches
- wp_backup_site- Create site backups

- wp_install_plugin- Install from repository
- wp_activate_plugin- Activate installed plugins
- wp_update_plugin- Update to latest version
- wp_list_themes- Available themes

- wp_create_user- Add new users
- wp_update_user- Modify user details
- wp_list_users- Get user listings
- wp_manage_roles- Role and capability management

- Verify WordPress URL is correct
- Check REST API is enabled:https://yoursite.com/wp-json/
- Ensure credentials are valid

- Application passwords require WordPress 5.6+
- Username should be your login name, not email
- Some hosts block REST API authentication

- User needs appropriate WordPress capabilities
- Check plugin/theme installation permissions
- Verify file upload limits

export WP_MCP_DEBUG=true npx wordpress-mcp-server start

- CheckClaude Code Setup Guide
- VisitIssues
- Join ourDiscord Community

We welcome contributions! Please see ourContributing Guidelinesfor details.

For security concerns, please review ourSecurity Policyand report issues responsibly.

This project is licensed under the MIT License - see theLICENSEfile for details.

- Built on theModel Context Protocolstandard
- WordPress REST API documentation and community
- Claude and Anthropic for MCP development

Works the tickets of the self hosted Simple Support System helpdesk for Concrete CMS: read a ticket with its comments, reply, change its state, manage attachments.