wp-mcp
Provides tools for operating WordPress sites, including content management (posts, pages, custom post types), media uploads, plugin and theme management, direct editing of files under wp-content with backup/restore, cache purging, and raw REST API access.
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., "@wp-mcpcreate a new post about our services and publish it"
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.
wp-mcp
![]()
MCP server that turns Claude Code into a full WordPress operator — content, media, plugins, themes, and direct theme-file editing — on any site, including shared hosting with no SSH/WP-CLI.
How it works
Two halves:
bridge/wp-mcp-connector.zip— a small WordPress plugin you upload once per site. It provides the token-based connection, file endpoints (scoped towp-content), a plugin/theme installer, and a standalonerescue.phpthat can restore a backup even when a broken PHP edit has taken the site down.server.mjs— the MCP server registered in Claude Code. It talks to the plugin plus WordPress's core REST API.
Connection lifecycle (the whole security model)
Upload
wp-mcp-connector.zipon the site (Plugins → Add New → Upload) and activate it.wp-admin → Settings → WP MCP → Generate token (pick expiry: 1h / 8h / 24h / 7d). The token is shown once. A new token replaces any previous one.
Tell Claude:
connect to https://example.com with token wpmcp_xxx, call it "clientx".Work: edit theme files, install plugins, write posts, whatever.
Say
disconnect from clientx— the token is revoked on the site and forgotten locally.Next session: generate a fresh token, reconnect.
No standing credentials live anywhere. sites.json (gitignored, chmod 600) holds
only the currently connected sites.
Related MCP server: AutoWP MCP Server
Setup (one time, on this Mac)
cd ~/mcp/wp-mcp && npm install
claude mcp add --scope user wordpress -- node ~/mcp/wp-mcp/server.mjsTools
tool | does |
| connection lifecycle |
| posts, pages, any custom post type |
| local file → media library |
| list / install (wp.org slug or zip URL) / activate / deactivate / update / delete |
| list / install / activate / delete |
| direct files under |
| undo a file write from its automatic |
| purge known page caches (Jetpack Boost, WP Super Cache / W3TC, LiteSpeed) after changes |
| raw REST escape hatch ( |
Safety notes
Every
wp_file_writeover an existing file first saves<file>.wpmcp-bak. If an edit tofunctions.phpwhite-screens the site,wp_file_restorestill works:rescue.phpruns without loading WordPress at all.File access is limited to
wp-content. To allow the whole WP root (e.g.wp-config.phpedits), adddefine('WPMCP_ALLOW_FULL', true);to wp-config.php.Use HTTPS sites only — the token travels in a header.
Some shared hosts strip the
Authorizationheader; the server also sendsX-WPMCP-Token, which survives everywhere tested.On multisite, plugin/theme installs need a super-admin's token.
HTML passed to
wp_content_create/wp_content_updateis wrapped in a raw-HTML block by default, so WordPress's autop filter can't reformat structured markup (passautop_safe: falseto opt out).All requests send a browser-like User-Agent — some shared-host WAFs reject non-browser agents with an opaque 403.
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Hosted WordPress MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Run all of WordPress from Claude, ChatGPT or Cursor: SEO, security, your WooCommerce shop and Elementor pages, on up to 10 websites in one connector. Start free. SEO: titles, descriptions and focus keywords for every page, post and product. Security & updates: core, plugin and theme updates with a live test, site health and HTTPS checks, users and roles. WooCommerce shop: products, prices, orders, coupons and customers. Elementor and many more page builders: texts, links and images. Blog posts, pages, media, comments and menus. 10 websites in one connector: all your sites in the same chat. Deploy (Agency): build a site locally and push it to your own server. Just say it: "Write SEO titles for every product." "Install all updates and check that the site still works." "Show today's orders and create a weekend coupon." You choose what your AI may change, with one switch. Install the free AlphaBridge MCP plugin from WordPress.org, connect and approve on your own site. No account, no key to copy.
Let Claude, ChatGPT or any MCP client run your WordPress site, Pinterest and Search Console.
Related MCP Servers
- AlicenseCqualityAmaintenanceEnables comprehensive WordPress site management through natural language in Claude Desktop, supporting multiple sites with 59 tools for content creation, media management, user administration, and performance monitoring.712,308 npm113MIT
- AlicenseBqualityCmaintenanceConnects Claude to WordPress sites through the REST API, enabling AI-assisted content creation, publishing, media management, user administration, and site maintenance tasks through natural language.4723 npm23MIT
- AlicenseCqualityBmaintenanceEnables Claude Code to read, edit, and manage WordPress pages, posts, shortcodes, and media via the WordPress REST API.8012 npm3MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude Code to directly manage WordPress sites via natural language, including posts, pages, categories, tags, media, and multiple site support.MIT