WordPress MCP Server — Claude Code MCP server: what it does
An MCP server that hands your assistant the WordPress database: posts, comments, users, terms, metadata and site settings. Useful when you edit content from a chat instead of wp-admin.
claude mcp add wp-mcp -e LOCAL_USERNAME=<LOCAL_USERNAME> -e WP_DB_HOST=<WP_DB_HOST> -e WP_DB_NAME=<WP_DB_NAME> -e WP_DB_USER=<WP_DB_USER> -e WP_DB_PASSWORD=<WP_DB_PASSWORD> -- npx -y @rnaga/wp-mcpWhat WordPress MCP Server does
The server sits on top of @rnaga/wp-node and exposes a toolset for CRUD work: create, read, update and delete posts along with their revisions, moderate comment threads, change user roles, handle categories, tags and custom taxonomies, edit meta fields and site options. Two deployment shapes are available. A local STDIO server talks to the database directly; a Streamable HTTP server covers remote access. Clients that cannot do OAuth or Application Password can go through the CLI proxy, which presents itself as a local MCP server and forwards requests to the HTTP endpoint.
A CLI named wp-mcp ships with the project. It walks you through the database connection (npx @rnaga/wp-mcp -- local config-set asks for host, port, database name, user and password), scaffolds an Express-based HTTP server, authenticates against a remote WordPress install and keeps credentials under ~/.wp-mcp. To see which primitives exist and what they require, run npx @rnaga/wp-mcp -- utils list-prims — the table lists each primitive, its required capabilities and allowed roles.
LOCAL_USERNAME in the client config is not optional. The server reads that WordPress user's capabilities to decide which tools to expose at all: an administrator gets the full set, including post deletion and user management, while a subscriber sees a narrow slice. That filtering is what keeps a privileged call from firing by accident.
What it helps with
- draft a post and publish it without leaving the chat
- work through a comment queue and reply to some of them
- promote a contributor to editor or disable an account
- fix meta fields across posts and terms in one pass
- flip site options without opening the admin panel
Example prompts for the agent
- List the latest drafts and show me their titles
- Create a post titled "Quarterly recap" and save it as a draft
- Show every user with the editor role
How to install WordPress MCP Server
Platform CLI
claude mcp add wp-mcp -e LOCAL_USERNAME=<LOCAL_USERNAME> -e WP_DB_HOST=<WP_DB_HOST> -e WP_DB_NAME=<WP_DB_NAME> -e WP_DB_USER=<WP_DB_USER> -e WP_DB_PASSWORD=<WP_DB_PASSWORD> -- npx -y @rnaga/wp-mcpReplace <…> with your own values. 8 more environment variables are in the server README
Platform CLI
codex mcp add wordpress-mcp-server --env LOCAL_USERNAME=<LOCAL_USERNAME> --env WP_DB_HOST=<WP_DB_HOST> --env WP_DB_PORT=<WP_DB_PORT> --env WP_DB_NAME=<WP_DB_NAME> --env WP_DB_USER=<WP_DB_USER> -- npx -y @rnaga/wp-mcpReplace <…> with your own values. 8 more environment variables are in the server README
Config file
{
"mcpServers": {
"wordpress-mcp-server": {
"command": "npx",
"args": [
"-y",
"@rnaga/wp-mcp"
],
"env": {
"LOCAL_USERNAME": "<LOCAL_USERNAME>",
"WP_DB_HOST": "<WP_DB_HOST>",
"WP_DB_PORT": "<WP_DB_PORT>",
"WP_DB_NAME": "<WP_DB_NAME>",
"WP_DB_USER": "<WP_DB_USER>"
}
}
}
}Replace <…> with your own values. 8 more environment variables are in the server README
Config file
{
"servers": {
"wordpress-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@rnaga/wp-mcp"
],
"env": {
"LOCAL_USERNAME": "<LOCAL_USERNAME>",
"WP_DB_HOST": "<WP_DB_HOST>",
"WP_DB_PORT": "<WP_DB_PORT>",
"WP_DB_NAME": "<WP_DB_NAME>",
"WP_DB_USER": "<WP_DB_USER>"
}
}
}
}Replace <…> with your own values. 8 more environment variables are in the server README
Platform CLI
gemini mcp add -e LOCAL_USERNAME=<LOCAL_USERNAME> -e WP_DB_HOST=<WP_DB_HOST> -e WP_DB_PORT=<WP_DB_PORT> -e WP_DB_NAME=<WP_DB_NAME> -e WP_DB_USER=<WP_DB_USER> wordpress-mcp-server npx -y @rnaga/wp-mcpReplace <…> with your own values. 8 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about WordPress MCP Server
How do I install WordPress MCP Server in Claude Code?
Run `claude mcp add wp-mcp -e LOCAL_USERNAME=<LOCAL_USERNAME> -e WP_DB_HOST=<WP_DB_HOST> -e WP_DB_NAME=<WP_DB_NAME> -e WP_DB_USER=<WP_DB_USER> -e WP_DB_PASSWORD=<WP_DB_PASSWORD> -- npx -y @rnaga/wp-mcp`, replacing the placeholders with your own values.
What does WordPress MCP Server do?
It gives an assistant tools for the WordPress database: posts and revisions, comments, users and their roles, terms, metadata, options and site settings.
Why are some tools missing from my client?
Primitives are filtered by the capabilities of the user named in LOCAL_USERNAME. An administrator sees everything, a subscriber only a small subset.
