What is Mcp Wordpress

mcp-wordpress is a Model Context Protocol (MCP) server designed for interacting with WordPress sites. It enables users to fetch posts, pages, categories, and site information from any WordPress installation that has the REST API enabled.

Use cases

Use cases for mcp-wordpress include building custom dashboards for WordPress site management, creating mobile applications that display WordPress content, and integrating WordPress data into other web applications.

How to use

To use mcp-wordpress, first ensure you have Python 3.13 and a WordPress site with the REST API enabled. Install the UV package, clone the repository, create a virtual environment, and install the necessary dependencies. Configure the server by creating a .env file with your WordPress site URL, then start the server and connect it to your application.

Key features

Key features of mcp-wordpress include tools to fetch basic site information, recent posts, categories, posts by category, site pages, and specific posts by ID. It provides a flexible and efficient way to interact with WordPress data.

Where to use

mcp-wordpress can be used in web development, content management systems, and applications that require integration with WordPress sites. It is particularly useful for developers looking to build custom applications that leverage WordPress content.

WordPress MCP Server

A Model Context Protocol (MCP) server for interacting with WordPress sites. This server provides tools to fetch posts, pages, categories, and site information from any WordPress installation with REST API enabled.

Prerequisites

• Python 3.13
• WordPress site with REST API enabled
• UV package installer (recommended)

Installation

1. Install UV (Universal Virtualenv):

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone the repository:

git clone <repository-url>
cd wordpress

3. Create and activate a virtual environment:

uv venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

4. Install dependencies using UV:

uv add "mcp[cli]" httpx

Configuration

1. Create a .env file in the project root:

WORDPRESS_URL="https://your-wordpress-site.com"

Usage

Using Claude for Desktop:

• First, start the server:

uv run main.py

• In Claude for Desktop, go to Settings > Developer
• Click “Edit Config”
• Alternative Edit config approach using VSCode in Mac/Windows:

  # For Mac Users
  code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  
  # For Windows Users
  code $env:AppData\Claude\claude_desktop_config.json
  

• Add the file to config:

{
    "mcpServers": {
        "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/wordpress",
                "run",
                "main.py"
            ]
        }
    }
}

The server provides these testable tools:

• fetch_wordpress_info: Get basic site information
• fetch_posts: Get recent posts
• fetch_categories: List all categories
• fetch_posts_by_category: Get posts in a specific category
• fetch_pages: Get site pages
• fetch_post_by_id: Get a specific post
• fetch_page_by_id: Get a specific page

Error Handling

The server includes robust error handling for:

• Invalid JSON responses
• Network errors
• WordPress API errors
• Invalid URLs
• API authentication issues