# 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
# 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
Site 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 versionget_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
Page Tools
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
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