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/yourusername/wordpress-mcp-server.git
cd wordpress-mcp-server
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

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"
    }
  }
}

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

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
Check API credits
Ensure proper .env file format

"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: your-email@example.com
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions

Made with ❤️ for WordPress developers and AI enthusiasts

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

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 Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
2
Python
Appwrite MCP Serverofficial
appwrite
A
security
A
license
A
quality
A Model Context Protocol server that allows AI assistants to interact with Appwrite's API, providing tools to manage databases, users, functions, teams, and other resources within Appwrite projects.
Last updated -
84
40
Python
MIT License
Office Word MCP Server
GongRzhe
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to create, read, edit, and format Microsoft Word documents through standardized tools and resources.
Last updated -
16
198
Python
MIT License
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 -
16
TypeScript

View all related MCP servers

WordPress MCP Server