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
- Author
- gopalcnepal
- Downloads
- 265
- Categories
- Other
Jump to
- 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
Install via UV, clone the repository, create a virtual environment, and install dependencies. Configure a .env file with WORDPRESS_URL. Start the server with uv run main.py and add the server’s configuration to Claude for Desktop’s claude_desktop_config.json. Tools include fetch_wordpress_info, fetch_posts, fetch_categories, fetch_posts_by_category, fetch_pages, fetch_post_by_id, and fetch_page_by_id.
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"
]
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
