WordPress MCP Server
About
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.
Details
- License
- MIT license
Explore
- Fetches site info, posts, pages, and categories
- Supports filtering posts by category
- Retrieves individual posts and pages by ID
- Requires Python 3.13 and WordPress REST API enabled
- Uses UV for dependency management
- Includes error handling for network and API errors
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
WordPress MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Python 3.13
- WordPress site with REST API enabled
- UV package installer (recommended)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"wordpress mcp server": {
"mcp-wordpress": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"mcp-wordpress": {
"command": "uv",
"args": [
"venv"
]
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
