wordpress-mcp
Manage posts, pages, media, comments, categories, tags, and users through 20 tools.
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 Create a new draft post titled 'My First Post'"
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
MCP (Model Context Protocol) server for WordPress REST API. Manage posts, pages, media, comments, categories, tags, and users through 20 tools. Secure and optimized edition.
Works with Claude Desktop, Cursor, VS Code, and any MCP client.
💡 Activation Keywords
This MCP server is always active in the hub. Agents automatically invoke it based on context using these trigger keywords:
WordPress/blog/site/article/post➔ triggerswp_list_posts,wp_get_post,wp_create_post,wp_update_post,wp_delete_postpage/landing page/parent➔ triggerswp_list_pages,wp_create_page,wp_update_page,wp_delete_pagemedia/image/gallery/file➔ triggerswp_list_media,wp_delete_mediacomments/moderate/approve/spam➔ triggerswp_list_comments,wp_create_comment,wp_update_comment,wp_delete_commentcategory/tag/taxonomy➔ triggerswp_list_categories,wp_list_tagsusers/roles/site info/settings➔ triggerswp_list_users,wp_get_site_info
Quick Start
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"wordpress": {
"command": "npx",
"args": ["-y", "@alexgenovese/wordpress-mcp"],
"env": {
"WORDPRESS_URL": "https://your-site.com",
"WORDPRESS_USERNAME": "your-username",
"WORDPRESS_APP_PASSWORD": "your-application-password"
}
}
}
}Cursor / VS Code
Add to MCP settings:
{
"mcpServers": {
"wordpress": {
"command": "npx",
"args": ["-y", "@alexgenovese/wordpress-mcp"],
"env": {
"WORDPRESS_URL": "https://your-site.com",
"WORDPRESS_USERNAME": "your-username",
"WORDPRESS_APP_PASSWORD": "your-application-password"
}
}
}
}HTTP Mode (Streamable HTTP)
For remote deployment or shared access:
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npx @alexgenovese/wordpress-mcp --httpServer starts on port 3000 (configurable via PORT env var). MCP endpoint: http://localhost:3000/mcp
Related MCP server: wp-mcp
Configuration
Environment Variable | Required | Description |
| Yes | WordPress site URL (e.g. |
| Yes | WordPress username |
| Yes | Application Password (see below) |
| No | Port for HTTP server (default: |
How to Create an Application Password
Go to your WordPress Admin → Users → Profile
Scroll down to Application Passwords
Enter a name (e.g. "MCP Server") and click Add New Application Password
Copy the generated password
Important: WordPress displays the password with spaces for readability (e.g.
cUAn CKZ1 u5DN). The server automatically removes spaces — you can paste it as-is.
All Tools (20 tools)
Posts (5 tools)
Tool | Description |
| List posts with filters (status, search, per_page) |
| Get single post with full content |
| Create post (title, content, status, categories, tags) |
| Update post fields |
| Delete post (moves to trash) |
Pages (5 tools)
Tool | Description |
| List pages with status filter |
| Get single page with full content |
| Create page (title, content, status, parent) |
| Update page fields |
| Delete page |
Media (2 tools)
Tool | Description |
| List media files with type filter |
| Permanently delete media file |
Comments (4 tools)
Tool | Description |
| List comments, filter by post |
| Create comment on post |
| Moderate comment (approve/hold/spam/trash) |
| Permanently delete comment |
Taxonomy (2 tools)
Tool | Description |
| List all categories with post counts |
| List all tags with post counts |
Users & Site (2 tools)
Tool | Description |
| List users with roles |
| Get site name, description, URL, timezone |
Requirements
Node.js 18+
WordPress with REST API enabled (enabled by default)
Application Password (WordPress 5.6+)
For Developers
git clone https://github.com/alexgenovese/mcp-wordpress.git
cd mcp-wordpress
npm install
npm run build
# Run in stdio mode
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm start
# Run in dev mode (hot reload)
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm run dev
# Run in HTTP mode
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm start -- --httpLicense
MIT License - see LICENSE
Copyright (c) 2026 Alex Genovese
Links
Available Tools
20 toolswp_create_commentB
Create a new comment on a WordPress post.
Inputs: post (required), content (required), author_name, author_email.
wp_create_pageA
Create a new WordPress page. Provide title and content (HTML). Optionally set parent page for hierarchy.
Inputs: title (required), content (required), parent, status.
wp_create_postA
Create a new WordPress post. Provide title and content (HTML). Optionally set status (draft/publish), categories, and tags.
Inputs: title (required), content (required), tags, status, +1 more.
wp_delete_commentADestructive
Permanently delete a comment.
Inputs: id (required).
wp_delete_mediaADestructive
Permanently delete a media file from WordPress.
Inputs: id (required).
wp_delete_pageBDestructive
Delete a WordPress page.
Inputs: id (required).
wp_delete_postADestructive
Delete a WordPress post. Moves to trash by default.
Inputs: id (required).
wp_get_pageARead-only
Get a single WordPress page with full content and metadata.
Inputs: id (required).
wp_get_postARead-only
Get a single WordPress post with full content, metadata, categories, and tags. Use to inspect post content before editing.
Inputs: id (required).
wp_get_site_infoARead-only
Get WordPress site information: name, description, URL, timezone, and available features.
Inputs: _fields.
wp_list_categoriesARead-only
List all WordPress categories with post counts.
Inputs: search, per_page.
wp_list_commentsARead-only
List comments on WordPress posts. Filter by post ID.
Inputs: post, per_page.
wp_list_mediaARead-only
List media files in the WordPress library. Returns file URLs, types, and metadata.
Inputs: per_page, media_type.
wp_list_pagesARead-only
List WordPress pages. Returns page ID, title, status, and parent page. Use to browse site page structure.
Inputs: status, per_page.
wp_list_postsARead-only
List WordPress posts with optional filters. Returns post ID, title, status, date, and categories. Use to browse existing content or find posts by keyword.
Inputs: search, status, per_page.
wp_list_tagsBRead-only
List all WordPress tags with post counts.
Inputs: search, per_page.
wp_list_usersARead-only
List WordPress users with their roles.
Inputs: search, per_page.
wp_update_commentAIdempotent
Update or moderate a comment. Change content or approval status.
Inputs: id (required), status, content.
wp_update_pageCIdempotent
Update an existing WordPress page.
Inputs: id (required), title, status, content.
wp_update_postAIdempotent
Update an existing WordPress post. Change title, content, status, categories, or tags.
Inputs: id (required), tags, title, status, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool targets a distinct resource and action (e.g., wp_get_page vs wp_list_pages, wp_create_post vs wp_create_comment). There is no ambiguity between tools that operate on different WordPress entities.
All tools follow a strict wp_verb_noun pattern (get, list, create, update, delete) with clear resource names. The convention is consistent across the entire set, making the API highly predictable.
20 tools is slightly heavier than the typical 3-15 range, but each tool corresponds to a specific WordPress operation across posts, pages, comments, media, and taxonomies. The count feels justified for the domain, though it borders on heavy.
Posts, pages, and comments have solid CRUD coverage, but media lacks upload/create and update capabilities, and categories/tags have only list operations. These are notable gaps for a WordPress management server, though core content workflows are supported.
Maintenance
Related MCP Connectors
WordPress plugin exposing 60 MCP tools via OAuth 2.1: posts, pages, media, users, comments and SEO.
WordPress MCP server: publish posts, AI images, SEO and full site management, self-hosted
WordPress MCP server: generate SEO posts, AI images, autoblog & WooCommerce on your self-hosted site
Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for managing WordPress sites through the REST API, featuring 38 tools for content, media, plugin, and theme management. It supports secure Application Password authentication and offers specific compatibility for Divi theme shortcode structures.MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for WordPress content management via REST API, supporting posts, pages, media, comments, and terms through natural language interfaces like Cursor, ChatGPT, Codex, and Claude.MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server for managing multiple WordPress sites via the WordPress REST API. It supports posts, categories, tags, media, comments, and site configuration through natural language.48 npmISC
- AlicenseBqualityBmaintenanceA secure MCP server for WordPress content management, enabling posts, pages, media, and comment operations through natural language.331AGPL 3.0