Claudeus WP MCP Server

How to use

You interact with the MCP server through an MCP client. Install the MCP client or run it via your preferred runtime, then configure it to connect to your WordPress sites. Once connected, you can explore tools by category, run individual tools with input data, and chain tools into automated workflows. Start by verifying you can reach your WordPress REST API, authenticate with an application password or JWT, and confirm that your site paths are correctly set up. Use AI‑assisted prompts to generate content, diagnose site health, and perform batch operations across posts, media, and settings.

How to install

# Prerequisites
Node.js ≥ 22.0.0
pnpm (recommended) or npm

# Install the MCP client globally
npm install -g claudeus-wp-mcp

# Or run directly with npx
npx claudeus-wp-mcp

If you are developing or testing locally, you can clone the project, install dependencies, and run a build and local inspector UI. The following steps assume you want to run the client in a development environment and inspect the available 145 WordPress tools.

Configuration

Create configuration files to connect to your WordPress sites and wire the MCP client to your Claude Desktop setup.

WP sites configuration

{
  "default_test": {
    "URL": "https://your-site.com",
    "USER": "admin",
    "PASS": "your-application-password",
    "authType": "basic"
  },
  "production": {
    "URL": "https://production-site.com",
    "USER": "admin",
    "PASS": "prod-app-password",
    "authType": "basic"
  }
}

Obtain an application password from WordPress by navigating to Users → Profile → Application Passwords, naming it (for example, "Claude MCP"), creating it, and copying the generated password.

Claude Desktop integration

Configure Claude Desktop to load your MCP server in the following path and add the MCP server entry to your Claude Desktop configuration.

Claude Desktop configuration example

{
  "mcpServers": {
    "claudeus_wp_mcp": {
      "command": "npx",
      "args": ["-y", "claudeus-wp-mcp"],
      "env": {
        "WP_SITES_PATH": "/absolute/path/to/your/wp-sites.json"
      }
    }
  }
}

Starting and using the MCP inspector

Restart Claude Desktop after updating the configuration, then look for the hammer icon in the input box to access all 145 WordPress tools. Use the Inspector UI to explore tools, test endpoints with sample data, view responses, and debug tool interactions.

Security and best practices

Follow best practices to protect credentials and data. Use application passwords or JWT tokens, enable input validation and output escaping, and monitor API usage. Always back up data before performing bulk or destructive actions, and test changes in a staging environment first.

Using the MCP Inspector

The Inspector UI lets you visually explore all tools, test endpoints with sample data, and review responses. Start the Inspector with the following command to interactively browse and test the 145 tools.

Troubleshooting

If you encounter connection issues, verify REST API access, confirm credentials, and double‑check the WP_SITES_PATH value in your Claude Desktop configuration. Check that Node.js and the MCP client versions are compatible and that your network allows outbound connections to your WordPress sites.

get_posts

Read a list of posts with options to filter by type, status, and author.

get_post

Retrieve a single post by ID or slug.

get_pages

List pages with optional depth and status filters.

get_page

Fetch a specific page by ID or slug.

get_blocks

List blocks within a post or page.

get_block

Retrieve a single block by its ID.

create_post

Create a new post with title, content, and metadata.

create_page

Create a new page with content and template data.

create_block

Insert a new block into a post or page.

update_post

Update fields of an existing post.

update_page

Update fields of an existing page.

update_block

Modify a block’s content or attributes.

delete_post

Delete a post by ID.

delete_page

Delete a page by ID.

delete_block

Delete a block by ID.

get_media

List media library items.

get_media_item

Fetch a specific media item by ID.

upload_media

Upload a file to the media library.

update_media

Update media item metadata.

delete_media

Remove a media item.

update_alt_text

Update the alt text of a media item for accessibility and SEO.

get_categories

List categories in a taxonomy.

get_category

Retrieve a single category by ID.

create_category

Create a new category in a taxonomy.

update_category

Update category details.

delete_category

Delete a category.

get_tags

List tags in a taxonomy.

get_tag

Retrieve a single tag by ID.

create_tag

Create a new tag in a taxonomy.

update_tag

Update tag details.

delete_tag

Delete a tag.

get_taxonomies

Discover available taxonomies.

get_terms

List terms within a taxonomy.

get_users

List site users.

get_user

Fetch a single user by ID.

get_me

Retrieve the authenticated user information.

create_user

Create a new user.

update_user

Update user data.

delete_user

Delete a user.

create_app_password

Create a new application password for a user.

list_app_passwords

List application passwords for a user.

revoke_app_password

Revoke an application password.

introspect_password

Inspect an application password’s validity.

get_comments

List comments on posts.

get_comment

Fetch a single comment.

create_comment

Create a new comment.

update_comment

Update a comment.

delete_comment

Delete a comment.

approve

Approve a pending comment.

spam

Mark a comment as spam.

trash

Move a comment to trash.

get_menus

List classic menus.

get_menu

Fetch a menu by ID.

create_menu

Create a new menu.

update_menu

Update a menu.

delete_menu

Delete a menu.

get_menu_items

List items within a menu.

create_menu_item

Add a new item to a menu.

update_menu_item

Update a menu item.

delete_menu_item

Remove a menu item.

get_locations

List menu locations.

get_templates

List full site editing templates.

get_template

Fetch a template by ID.

create_template

Create a new template.

update_template

Update a template.

delete_template

Delete a template.

get_template_parts

List template parts.

get_template_part

Fetch a template part.

create_template_part

Create a template part.

update_template_part

Update a template part.

delete_template_part

Delete a template part.

get_global_styles

Fetch global styles for the theme.

update_global_styles

Update global styles.

get_theme_global_styles

Retrieve theme‑level global styles.

get_global_style_variations

List variations of global styles.

get_global_style_revisions

Retrieve revisions of global styles.

get_global_style_revision

Fetch a specific global style revision.

get_local_patterns

Discover local block patterns.

get_pattern_categories

List block pattern categories.

search_pattern_directory

Search the local block pattern directory.

get_mega_menu

Fetch Astra Pro mega menu.

update_mega_menu

Update Astra Pro mega menu.

enable_mega_menu

Enable Astra Pro mega menu.

disable_mega_menu

Disable Astra Pro mega menu.

get_custom_layouts

List Astra Pro custom layouts.

get_custom_layout

Fetch a custom layout.

create_custom_layout

Create a custom layout.

update_custom_layout

Update a custom layout.

delete_custom_layout

Delete a custom layout.

get_settings

Get site or theme settings.

update_settings

Update site or theme settings.

get_post_types

List registered post types.

get_post_type

Fetch details of a post type.

get_post_statuses

List post status values.

list

Generic listing endpoint for various resources.

get

Fetch a generic resource by ID.

activate

Activate a plugin or feature.

deactivate

Deactivate a plugin or feature.

delete

Delete a resource such as a plugin or data item.

get_sidebars

List sidebars.

get_sidebar

Get a single sidebar.

get_widgets

List widgets.

get_widget

Fetch a widget by ID.

create_widget

Create a new widget.

update_widget

Update a widget.

delete_widget

Delete a widget.

list_themes

List installed themes.

get_custom_css

Fetch custom CSS for a theme.

update_custom_css

Update custom CSS for a theme.

test_auth

Test authorization headers.

test_background_updates

Test background update system.

test_dotorg_communication

Test connectivity to WordPress.org.

test_https

Validate HTTPS configuration.

test_loopback

Test loopback requests.

test_page_cache

Validate page caching.

get_directory_sizes

Report storage usage.

run_all_tests

Run the full health test suite.

search

Universal content search across site data.

oembed

Fetch oEmbed data for a URL.

oembed_proxy

Proxy for external oEmbed endpoints.

get_url_details

Retrieve metadata for a given URL.

block_directory

Search WordPress block directory.

get_products

List WooCommerce products.

get_orders

List WooCommerce orders.

get_sales

Fetch WooCommerce sales analytics.

discover_endpoints

Discover available API endpoints and capabilities.