mcp-wordpress-remote

MCP.Pizza Chef: Automattic

The mcp-wordpress-remote server acts as a proxy between local MCP clients and remote WordPress MCP servers. It simplifies integration by using REST API calls instead of streaming protocols, improving efficiency and security. It supports WordPress API passwords and WooCommerce REST API keys, enabling OAuth2.1-like security. This server requires the wordpress-mcp plugin installed on the WordPress site and facilitates easy, secure, and efficient communication for MCP clients without maintaining persistent connections.

Use This MCP server To

Proxy MCP client requests to remote WordPress MCP servers Enable secure REST API communication with WordPress sites Simplify MCP client integration with WordPress without streaming support Use WordPress API passwords and WooCommerce keys for authentication Improve efficiency by avoiding persistent connections to WordPress Facilitate OAuth2.1-like security for MCP interactions Run MCP WordPress proxy without global installation via npx

README

MCP WordPress Remote

The mcp-wordpress-remote package acts as a bridge between local Model Context Protocol (MCP) clients and remote WordPress MCP servers. By leveraging npx, you can execute this package without a global installation, simplifying the setup process.

WordPress MCP plugin

You have to install the wordpress-mcp plugin on your WordPress website, and enable MCP Functionality on Settings > MCP Settings.

Why

  1. Most of the clients does not suport SSE or Streamable communications protocols.
  2. Improved eficiency. This proxy will not keep an open connection to your website, and it will only make simple REST API requests to your website when needed.
  3. Oauth2.1 is not yet available on wordpress out of the box.
  4. Security trough WordPress API passwords and WooCommerce REST API cosumer key and secret
  5. Easy to use. See installation instructions below.

Usage

Environment Variables

The following environment variables are required:

  • WP_API_URL: The URL of your WordPress site (e.g., https://example.com)
  • WP_API_USERNAME: Your WordPress username
  • WP_API_PASSWORD: Your WordPress application password
  • WOO_CUSTOMER_KEY: Your Woocommerce customer key (optional, if you intend to use WooCommerce MCP assets)
  • WOO_CUSTOMER_SECRET: Your WooCommerce customer secret (optional, if you intend to use WooCommerce MCP assets)
  • LOG_FILE: Optional full path to a log file

Configuration in MCP Clients

Claude Desktop

In order to add an MCP server to Claude Desktop you need to edit the configuration file located at:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Example configuration:

{
  "mcpServers": {
    "wordpress-mcp": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote"],
      "env": {
        "WP_API_URL": "https://your-wordpress-site.com",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-password",
        "WOO_CUSTOMER_KEY": "your-woo-customer-key",
        "WOO_CUSTOMER_SECRET": "your-woo-customer-secret",
        "LOG_FILE": "optional full path to the log file"
      }
    }
  }
}

https://woocommerce.com/document/woocommerce-rest-api/

Cursor

The configuration file is located at ~/.cursor/mcp.json.

Example configuration:

{
  "mcpServers": {
    "wordpress-mcp": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote"],
      "env": {
        "WP_API_URL": "https://your-wordpress-site.com",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-password",
        "WOO_CUSTOMER_KEY": "your-woo-customer-key",
        "WOO_CUSTOMER_SECRET": "your-woo-customer-secret",
        "LOG_FILE": "optional full path to the log file"
      }
    }
  }
}

@todo

As of now, this package is in its early development stages. Any suggestions, bugreports, PR's are welcome.

mcp-wordpress-remote FAQ

How do I install the mcp-wordpress-remote server?
You can run it directly using npx without global installation, simplifying setup.
What WordPress plugin is required for this server?
The wordpress-mcp plugin must be installed and MCP enabled on your WordPress site.
How does this server improve communication efficiency?
It uses simple REST API requests instead of keeping open streaming connections, reducing resource use.
What authentication methods does mcp-wordpress-remote support?
It supports WordPress API passwords and WooCommerce REST API consumer key and secret for secure access.
Can I use this server with OAuth2.1?
OAuth2.1 is not natively available on WordPress, but this server provides similar security via API keys.
Why is this server needed for MCP clients?
Many MCP clients do not support SSE or streaming protocols required by WordPress MCP servers, so this proxy bridges that gap.
Is this server compatible with multiple LLM providers?
Yes, it works with any MCP client regardless of the underlying LLM provider, including OpenAI, Claude, and Gemini.