Read WordPress content, ACF fields, and Yoast SEO data, and safely edit drafts.
Connect Runs on your machine
claude mcp add wp-headless-mcp -e WP_URL=<WP_URL> -e MCP_PROFILE=<MCP_PROFILE> -e WP_USER=<WP_USER> -e WP_APP_PASSWORD=<WP_APP_PASSWORD> -e WP_CACHE_TTL=<WP_CACHE_TTL> -e ACF_JSON_PATH=<ACF_JSON_PATH> -e MCP_CPTS=<MCP_CPTS> -- npx -y [email protected]{
"mcpServers": {
"wp-headless-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"WP_URL": "<WP_URL>",
"MCP_PROFILE": "<MCP_PROFILE>",
"WP_USER": "<WP_USER>",
"WP_APP_PASSWORD": "<WP_APP_PASSWORD>",
"WP_CACHE_TTL": "<WP_CACHE_TTL>",
"ACF_JSON_PATH": "<ACF_JSON_PATH>",
"MCP_CPTS": "<MCP_CPTS>"
}
}
}
}{
"mcpServers": {
"wp-headless-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"WP_URL": "<WP_URL>",
"MCP_PROFILE": "<MCP_PROFILE>",
"WP_USER": "<WP_USER>",
"WP_APP_PASSWORD": "<WP_APP_PASSWORD>",
"WP_CACHE_TTL": "<WP_CACHE_TTL>",
"ACF_JSON_PATH": "<ACF_JSON_PATH>",
"MCP_CPTS": "<MCP_CPTS>"
}
}
}
}{
"servers": {
"wp-headless-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"WP_URL": "<WP_URL>",
"MCP_PROFILE": "<MCP_PROFILE>",
"WP_USER": "<WP_USER>",
"WP_APP_PASSWORD": "<WP_APP_PASSWORD>",
"WP_CACHE_TTL": "<WP_CACHE_TTL>",
"ACF_JSON_PATH": "<ACF_JSON_PATH>",
"MCP_CPTS": "<MCP_CPTS>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
WP_URLRequired | Base URL of the WordPress site, without a trailing slash |
MCP_PROFILEOptional | Tool profile: public (read published content), editor (adds draft-only editing), or dev (adds developer tools) |
WP_USEROptional | WordPress user for the Application Password (editor and dev profiles) |
WP_APP_PASSWORDOptional, secret | WordPress Application Password (editor and dev profiles) |
WP_CACHE_TTLOptional | Seconds to cache GET requests; 0 turns caching off |
ACF_JSON_PATHOptional | Absolute path to the theme's acf-json folder, for ACF labels, schemas, and TypeScript types |
MCP_CPTSOptional | Custom post type tools: auto, none, or a JSON array of {postType, singular, plural} |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 9 Nov 2026 |
| Last updated | 9 Nov 2026 |
| Registry name | io.github.aj-ua/wp-headless-mcp |
More browser automation servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.