How do I install MCP Wordpress?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does MCP Wordpress need an API key?

No required environment variable is listed on this record.

What transport does MCP Wordpress use?

MCP Wordpress runs locally over stdio.

When was MCP Wordpress last checked?

Last checked 2026-11-09. Secure MCP server for WordPress content management

MCP Wordpress MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx mcp-wordpress-crunchtools==0.4.1

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.crunchtools-wordpress -- uvx mcp-wordpress-crunchtools==0.4.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.crunchtools-wordpress": {4      "command": "uvx",5      "args": [6        "mcp-wordpress-crunchtools==0.4.1"7      ]8    }9  }10}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.4.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

MCP WordPress CrunchTools

A secure MCP (Model Context Protocol) server for WordPress content management. Designed for developers publishing about their work.

Overview

This MCP server is designed to be:

Secure by default - Input validation, credential protection, and SSRF prevention
No third-party services - Runs locally via stdio, your credentials never leave your machine
Cross-platform - Works on Linux, macOS, and Windows
Automatically updated - GitHub Actions monitor for CVEs and update dependencies
Containerized - Available at quay.io/crunchtools/mcp-wordpress

Naming Convention

Component	Name
GitHub repo	crunchtools/mcp-wordpress
Container	`quay.io/crunchtools/mcp-wordpress`
Python package (PyPI)	`mcp-wordpress-crunchtools`
CLI command	`mcp-wordpress-crunchtools`
Module import	`mcp_wordpress_crunchtools`

Features

33 Tools for posts, pages, media, and comments
Security-focused: Credentials protected, input validation, SSRF prevention
Developer workflow: Scheduled publishing, revisions, search
Easy integration: Works with Claude Code and other MCP clients

Installation

With uvx (recommended)

uvx mcp-wordpress-crunchtools

With pip

pip install mcp-wordpress-crunchtools
mcp-wordpress-crunchtools

With Container

# Create a shared upload directory (required before first run)
mkdir -p ~/.local/share/mcp-uploads-downloads

podman run -v ~/.local/share/mcp-uploads-downloads:/tmp/mcp-uploads:z \
  -e WORDPRESS_URL=https://example.com \
  -e WORDPRESS_USERNAME=admin \
  -e WORDPRESS_APP_PASSWORD='xxxx xxxx xxxx xxxx' \
  quay.io/crunchtools/mcp-wordpress

SELinux note: Use :z (lowercase, shared) instead of :Z (uppercase, private). MCP servers run as long-lived stdio processes. With :Z, files copied into the directory after container start won't have the container's private MCS label and will be invisible inside the container. The :z flag sets a shared container_file_t context that all containers and the host can read/write.

Tip: Use the same shared directory (~/.local/share/mcp-uploads-downloads/) across multiple MCP container servers (e.g., mcp-wordpress and mcp-gemini) so generated files are immediately available for upload without copying.

From source

git clone https://github.com/crunchtools/mcp-wordpress.git
cd mcp-wordpress
uv sync --all-extras
uv run mcp-wordpress-crunchtools

Configuration

Set these environment variables:

Variable	Description	Example
`WORDPRESS_URL`	WordPress site URL	`https://example.com`
`WORDPRESS_USERNAME`	WordPress username	`admin`
`WORDPRESS_APP_PASSWORD`	Application password	`xxxx xxxx xxxx xxxx`
`MCP_UPLOAD_DIR`	Upload directory inside container (optional)	`/tmp/mcp-uploads` (default)

Creating an Application Password

Log in to WordPress admin
Go to Users → Profile
Scroll to Application Passwords
Enter a name (e.g., "MCP Server") and click Add New
Copy the generated password (shown once)

Usage with Claude Code

Using uvx (recommended)

claude mcp add mcp-wordpress-crunchtools \
    --env WORDPRESS_URL=https://example.com \
    --env WORDPRESS_USERNAME=admin \
    --env WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx" \
    -- uvx mcp-wordpress-crunchtools

Using pip

pip install mcp-wordpress-crunchtools

claude mcp add mcp-wordpress-crunchtools \
    --env WORDPRESS_URL=https://example.com \
    --env WORDPRESS_USERNAME=admin \
    --env WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx" \
    -- mcp-wordpress-crunchtools

Using Container

# Create a shared upload directory (required before first run)
mkdir -p ~/.local/share/mcp-uploads-downloads

claude mcp add mcp-wordpress-crunchtools \
    --env WORDPRESS_URL=https://example.com \
    --env WORDPRESS_USERNAME=admin \
    --env WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx" \
    -- podman run -i --rm \
        -v ~/.local/share/mcp-uploads-downloads:/tmp/mcp-uploads:z \
        -e WORDPRESS_URL \
        -e WORDPRESS_USERNAME \
        -e WORDPRESS_APP_PASSWORD \
        quay.io/crunchtools/mcp-wordpress

Available Tools

Tool	Description
`wordpress_get_site_info`	Get site title, description, URL, timezone
`wordpress_test_connection`	Verify API credentials work

Editing Model

Reads return the source the editor saved (context=edit), never the rendered page, so what an agent reads is safe to write back. Changes go through the edit_* tools: the agent sends the exact text to replace and its replacement, the server applies it to the current source, and the post never round-trips through the agent. The post and page update and edit tools take an optional expected_version (the version get_post or get_page returned); when it is given, the write is refused if the item changed since. update_* refuses content that is rendered output. edit_draft edits only draft or pending posts, so a gateway can grant revision rights without the power to change published posts.

Post Tools

Tool	Description
`wordpress_list_posts`	List posts with filtering (status, category, search)
`wordpress_get_post`	Get single post by ID with its saved source (block markup included) and version
`wordpress_search_posts`	Search posts by keyword
`wordpress_create_post`	Create new post (supports scheduling)
`wordpress_update_post`	Update existing post; refuses rendered HTML, and a stale `expected_version` when given
`wordpress_edit_post`	Replace text in a post's source without resending the post
`wordpress_edit_draft`	Same as `edit_post`, for draft or pending posts only; refuses any other status
`wordpress_delete_post`	Delete/trash a post
`wordpress_list_revisions`	List revisions for a post
`wordpress_get_revision`	Get specific revision content
`wordpress_list_categories`	List available categories
`wordpress_list_tags`	List available tags

Tool	Description
`wordpress_list_pages`	List pages with filtering
`wordpress_get_page`	Get single page by ID with its saved source and version
`wordpress_create_page`	Create new page
`wordpress_update_page`	Update existing page; refuses rendered HTML, and a stale `expected_version` when given
`wordpress_edit_page`	Replace text in a page's source without resending the page
`wordpress_delete_page`	Delete/trash a page
`wordpress_list_page_revisions`	List page revisions

Media Tools

Tool	Description
`wordpress_list_media`	List media items
`wordpress_get_media`	Get media item details
`wordpress_upload_media`	Upload file from local path
`wordpress_update_media`	Update media metadata
`wordpress_delete_media`	Delete media item
`wordpress_get_media_url`	Get public URL for media

Comment Tools

Tool	Description
`wordpress_list_comments`	List comments with filtering
`wordpress_get_comment`	Get single comment
`wordpress_create_comment`	Add a comment to a post
`wordpress_update_comment`	Update comment content/status
`wordpress_delete_comment`	Delete a comment
`wordpress_moderate_comment`	Approve, hold, spam, or trash

Examples

Create a Draft Post

Create a new WordPress post titled "My Technical Article" with the content below. Keep it as a draft.

Schedule a Post

Update post ID 123 to publish on December 25, 2024 at 10:00 AM.

Upload an Image

Upload this image to WordPress and set the alt text to "Architecture diagram".

Find and Moderate Comments

List all comments in "hold" status and approve the legitimate ones.

Security

Credential Protection: All credentials stored as SecretStr, never logged
SSRF Prevention: REST API path hardcoded, cannot be overridden
Input Validation: All inputs validated via Pydantic models
Rate Limiting: Handles WordPress rate limits gracefully
TLS Enforcement: All requests use HTTPS with certificate validation
Size Limits: Response size limited to 10MB to prevent memory issues
Timeout: All requests timeout after 30 seconds

Development

# Install dev dependencies
uv sync --all-extras

# Run tests
uv run pytest

# Run linting
uv run ruff check src tests

# Run type checking
uv run mypy src

# Format code
uv run ruff format src tests

License

AGPL-3.0-or-later

Credits

Built by crunchtools.com

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install MCP Wordpress?

Does MCP Wordpress need an API key?

What transport does MCP Wordpress use?

When was MCP Wordpress last checked?

Documentation

MCP WordPress CrunchTools

Overview

Naming Convention

Features

Installation

With uvx (recommended)

With pip

With Container

From source

Configuration

Creating an Application Password

Usage with Claude Code

Using uvx (recommended)

Using pip

Using Container

Available Tools

Site Tools

Editing Model

Post Tools

Page Tools

Media Tools

Comment Tools

Examples

Create a Draft Post

Schedule a Post

Upload an Image

Find and Moderate Comments

Security

Development

License

Credits