WordPress MCP Server

WordPress MCP Server 🚀

A Model Context Protocol (MCP) server that enables AI assistants to manage WordPress sites and create content with AI-generated featured images.

✨ Features

🌐 Multi-Site Management - Control multiple WordPress sites from a single interface
🤖 AI-Powered Content - Create articles with automatic featured image generation using DALL-E 3
📝 Smart Publishing - Full control over categories, tags, and post status
🔐 Secure Authentication - Uses WordPress Application Passwords for API access
🌍 International Support - Full Unicode support for Hebrew, Arabic, and other languages
⚡ Bulk Operations - Create multiple articles across different sites efficiently

🎯 Use Cases

Content Agencies - Manage multiple client WordPress sites from one place
Blog Networks - Publish content across multiple blogs simultaneously
AI-Assisted Writing - Let AI help create content with relevant images
Multilingual Publishing - Create content in any language with proper support

📋 Prerequisites

Python 3.8 or higher
Claude Desktop (or any MCP-compatible client)
WordPress sites with REST API enabled
OpenAI API key (for image generation)

🚀 Quick Start

1. Clone and Install

git clone https://github.com/seomentor/wpmcp.git
cd wpmcp
pip install -r requirements.txt

2. Configure WordPress Sites

Edit config/wordpress_sites.yaml:

sites:
  - id: "site1"
    name: "My WordPress Blog"
    url: "https://myblog.com"
    username: "your-username"
    password: "your-app-password"

3. Set Up OpenAI (Optional, for images)

Create a .env file:

OPENAI_API_KEY=your-api-key-here

⚠️ Important Note: If you have an OPENAI_API_KEY already set in your Windows/Mac environment variables, it might override the one in .env. To avoid conflicts:

Remove any existing OPENAI_API_KEY from your system environment variables, OR
Add the API key directly to Claude Desktop config (see option 2 below)

4. Configure Claude Desktop

Add to Claude's config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server"
    }
  }
}

Option 2: Include OpenAI API Key in Claude Config (Recommended if having issues)

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server",
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

5. Start Using!

In Claude Desktop:

"Create an article about AI trends with an image on site1"

📚 Documentation

Available Commands

Command	Description	Example
List sites	Show all configured sites	"Show me all WordPress sites"
Create article	Create a new post	"Create an article about Python on site1"
Create with image	Create post with AI image	"Create article with image about space on blog1"
Test connection	Verify site access	"Test connection to site1"
Get categories	List site categories	"Show categories on site1"
Get tags	List site tags	"Show tags on site1"

WordPress Setup

Enable REST API (enabled by default in WordPress 5.0+)
Create Application Password:
- Go to Users → Profile → Application Passwords
- Generate new password
- Use in configuration
Required Permissions:
- edit_posts - Create and edit posts
- upload_files - Upload media
- manage_categories - Create categories
- manage_post_tags - Create tags

🎨 Image Generation

The server uses OpenAI's DALL-E 3 for automatic image generation:

Automatic prompts - Generated from article title and content
Smart filenames - SEO-friendly names based on content
Direct upload - Images uploaded directly to WordPress media library
Featured image - Automatically set as post featured image

Costs

Standard quality: ~$0.04 per image
HD quality: ~$0.08 per image

🔧 Advanced Configuration

Environment Variables

OPENAI_API_KEY=sk-...          # OpenAI API key for image generation

Configuration Options

settings:
  default_post_status: "draft"   # draft, publish, private
  default_post_format: "standard"
  max_retries: 3
  timeout: 30

🐛 Troubleshooting

Diagnostic Tool

Run the diagnostic script to check your setup:

python scripts/diagnose.py

This will check:

Python version
Required dependencies
Configuration files
Environment variables
OpenAI API key conflicts
Connection to OpenAI

Common Issues

"Server disconnected"

Check Python installation
Verify path in Claude config
Check for error messages in terminal

"Image generation failed"

Verify OpenAI API key is valid
Check API credits
Ensure proper .env file format
Check if you have conflicting OPENAI_API_KEY in system environment variables
Try adding the API key directly to Claude Desktop config (see Option 2 above)

"Authentication failed"

Regenerate WordPress application password
Check username is correct
Verify site URL includes protocol (https://)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

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

🙏 Acknowledgments

Model Context Protocol by Anthropic
WordPress REST API team
OpenAI for DALL-E 3

📞 Support

📧 Email: shay@seomentor.co.il
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions

Made with ❤️ by Shay Amos for WordPress developers, SEO`s and AI enthusiasts

Visit my website for more cool apps :) https://www.seomentor.co.il

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enables AI assistants to manage WordPress sites and create content with AI-generated featured images.

Related MCP Servers

MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
3
1
TypeScript
WordPress MCPofficial
Automattic
A
security
F
license
A
quality
A WordPress plugin that implements the Model Context Protocol to enable AI models and applications to interact with WordPress sites in a structured and secure way.
Last updated -
5
13
414
WordPress Standalone MCP Server
diazoxide
-
security
A
license
-
quality
A Model Context Protocol server that automatically discovers WordPress REST API endpoints and creates individual tools for each endpoint, enabling natural language management of WordPress sites.
Last updated -
4
JavaScript
MIT License
Hashnode MCP Server
sbmagar13
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants to programmatically interact with the Hashnode API for creating, updating, searching, and retrieving blog content.
Last updated -
3
Python
MIT License

View all related MCP servers

Appeared in Searches

A platform for professional networking and career development

WordPress MCP Server