WordPress MCP Server

Manage WordPress sites and create content with AI-generated featured images.

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

- 🌐 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

- 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

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

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

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

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

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

Windows:%APPDATA%\Claude\claude_desktop_config.jsonMac:~/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" } } } }

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

-

Enable REST API(enabled by default in WordPress 5.0+)

- Go to Users → Profile → Application Passwords
- Generate new password
- Use in configuration

- edit_posts- Create and edit posts
- upload_files- Upload media
- manage_categories- Create categories
- manage_post_tags- Create tags

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

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

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

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

Run the diagnostic script to check your setup:

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

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

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

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

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

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

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

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

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

Access WordPress.com feeds, notifications, tags, and manage blogs within Claude Desktop.