WordPress MCP Server
Provides tools to fetch posts, pages, categories, and site information from any WordPress installation with REST API enabled.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WordPress MCP Server fetch the 5 most recent posts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
Related MCP server: WordPressMCP Server
Installation
Install UV (Universal Virtualenv):
curl -LsSf https://astral.sh/uv/install.sh | shClone the repository:
git clone <repository-url>
cd wordpressCreate and activate a virtual environment:
uv venv
source .venv/bin/activate # On Windows, use `.venv\Scripts\activate`Install dependencies using UV:
uv add "mcp[cli]" httpxConfiguration
Create a
.envfile in the project root:
WORDPRESS_URL="https://your-wordpress-site.com"Usage
Using Claude for Desktop:
First, start the server:
uv run main.pyIn 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.jsonAdd 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 informationfetch_posts: Get recent postsfetch_categories: List all categoriesfetch_posts_by_category: Get posts in a specific categoryfetch_pages: Get site pagesfetch_post_by_id: Get a specific postfetch_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
Available Tools
7 toolsfetch_categoriesA
Fetch list of categories from a WordPress site. Returns: dict[str, Any]: The response from the WordPress API.
Inputs: no named parameters.
fetch_page_by_idA
Fetch a single page by ID from a WordPress site. Args: page_id (int): The ID of the page to fetch. Returns: dict[str, Any]: The response from the WordPress API.
Inputs: page_id (required).
fetch_pagesC
Fetch pages from a WordPress site. Args: page (int): The page number to fetch. per_page (int): The number of pages per page. Returns: dict[str, Any]: The response from the WordPress API.
Inputs: page, per_page.
fetch_post_by_idA
Fetch a single post by ID from a WordPress site. Args: post_id (int): The ID of the post to fetch. Returns: dict[str, Any]: The response from the WordPress API.
Inputs: post_id (required).
fetch_postsB
Fetch posts from a WordPress site. Args: page (int): The page number to fetch. per_page (int): The number of posts per page. Returns: dict[str, Any]: The response from the WordPress API.
Inputs: page, per_page.
fetch_posts_by_categoryA
Fetch posts by category name provided from a WordPress site. Args: category (str): The category name to filter posts by. page (int): The page number to fetch. Returns: dict[str, Any]: The response from the WordPress API.
Inputs: category (required), page.
fetch_wordpress_infoC
Fetch WordPress site information. Returns: dict[str, Any]: The response from the WordPress API.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct resource (categories, pages, posts, site info) or filtering method, with no overlap between them.
All tools follow a consistent 'fetch_<entity>[_by_<filter>]' pattern, using snake_case throughout.
7 tools is well-scoped for a read-only WordPress interface, covering the main retrieval needs without being excessive.
The server is read-only with no create, update, or delete operations, which is a significant gap for a full WordPress management experience.
Maintenance
Related MCP Connectors
Manage your WordPress site from your AI assistant: posts, pages, media, comments and WooCommerce.
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
WordPress plugin exposing 60 MCP tools via OAuth 2.1: posts, pages, media, users, comments and SEO.
Manage a WordPress site from your AI assistant: read, search, propose edits, Search Console data.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with WordPress sites through REST APIs, allowing programmatic management of posts, users, comments, categories, and tags with secure authentication.2950MIT
- AlicenseNot gradedqualityFmaintenanceEnables interaction with WordPress sites through the REST API, supporting content management for posts, pages, users, plugins, and custom post types with Application Password authentication.2,530 npm2MIT
- AlicenseNot gradedqualityBmaintenanceEnables interaction with WordPress sites through the WordPress REST API via natural language, supporting single and multi-site management, content and taxonomy operations, media uploads, and more.173 npm100GPL 3.0
- AlicenseAqualityBmaintenanceEnables comprehensive management of WordPress sites including posts, users, media, categories, tags, and site settings via the WordPress REST API.201Apache 2.0