Skip to main content
Glama

WordPress MCP Server

by seomentor
GitHub
Python
MIT License
1
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

WordPress MCP Server 🚀

MCP Python License: MIT

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

WordPress + AI = Magic

✨ 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

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

  2. Create Application Password:

    • Go to Users → Profile → Application Passwords

    • Generate new password

    • Use in configuration

  3. 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.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/AmazingFeature)

  3. Commit your changes (git commit -m 'Add some AmazingFeature')

  4. Push to the branch (git push origin feature/AmazingFeature)

  5. Open a Pull Request

📄 License

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

🙏 Acknowledgments

📞 Support

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
A
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.

  1. ✨ Features
    1. 🎯 Use Cases
      1. 📋 Prerequisites
        1. 🚀 Quick Start
          1. 1. Clone and Install
          2. 2. Configure WordPress Sites
          3. 3. Set Up OpenAI (Optional, for images)
          4. 4. Configure Claude Desktop
          5. 5. Start Using!
        2. 📚 Documentation
          1. Available Commands
          2. WordPress Setup
        3. 🎨 Image Generation
          1. Costs
        4. 🔧 Advanced Configuration
          1. Environment Variables
          2. Configuration Options
        5. 🐛 Troubleshooting
          1. Diagnostic Tool
          2. Common Issues
        6. 🤝 Contributing
          1. 📄 License
            1. 🙏 Acknowledgments
              1. 📞 Support

                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 -
                  33
                  1

                • 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
                  7
                  581

                • 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
                  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 -
                  4
                  MIT License
                  • Apple

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/seomentor/wpmcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server