How to Connect Claude to WordPress Using MCP: The Complete Step-by-Step Setup Guide

wordpress and claude

Artificial intelligence is rapidly transforming how websites are managed. One of the most powerful workflows emerging today is connecting Claude directly to a WordPress site using the Model Context Protocol (MCP). Once configured, Claude can interact with your WordPress environment programmatically through built-in tools.

This guide walks you through the entire setup processโ€”from installing the required plugin to configuring Claude Desktopโ€”so you can establish a fully working connection between Claude and WordPress.

The tutorial focuses purely on configuration and setup. By the end, you will have a functional Claude โ†” WordPress MCP connection ready for use.

Prerequisites

Before starting the installation process, make sure you have the following:

  • A working WordPress installation
  • Administrator access to your WordPress dashboard
  • The ability to install plugins
  • Claude Desktop installed on your computer
  • A text editor (such as VS Code) to modify configuration files

The integration relies on a dedicated WordPress plugin and Claude Desktop’s MCP connector system.

Step 1 โ€” Download the WordPress MCP Plugin

The integration begins by installing a dedicated plugin that exposes WordPress functionality through MCP tools.

First, download the plugin archive from the official repository. The plugin is distributed as a ZIP file. Make sure to download the latest version available (for example version 2.5).

Once downloaded, keep the ZIP file ready on your computer because it will be uploaded directly into WordPress.


Step 2 โ€” Install the Plugin in WordPress

Next, install the plugin in your WordPress environment.

Inside your WordPress admin panel:

  1. Navigate to Plugins โ†’ Add New
  2. Click Upload Plugin
  3. Select the downloaded WordPress MCP ZIP file
  4. Click Install Now
  5. Activate the plugin once installation finishes

After activation, the plugin will appear in your list of installed extensions under the name WordPress MCP.


Step 3 โ€” Enable MCP Functionality in the Plugin Settings

After installation, the plugin must be configured.

Open the plugin settings by navigating to:

WordPress MCP โ†’ Settings

You will see several configuration options. Three options must be enabled for the integration to work properly.

  • Enable MCP Functionality
  • Enable Create Tools
  • Enable Update Tools

These settings activate the MCP bridge between WordPress and Claude.

Once enabled, WordPress exposes multiple internal tools that Claude can access, such as retrieving posts, adding content, or updating existing resources.

After enabling the options above, no additional configuration is required inside the plugin interface.


Step 4 โ€” Generate an Authentication Token

To allow Claude to securely communicate with WordPress, the plugin generates an authentication token.

Inside the same settings page, locate the Token Generation section.

Configure the token parameters:

  • Select the token duration
  • Choose a validity period

A longer duration (for example 30 days) is often more convenient because it avoids having to regenerate tokens frequently.

After choosing the duration:

  1. Click Generate Token
  2. Copy the generated authentication token
  3. Save it temporarily

This token will be required when configuring Claude Desktop.


Step 5 โ€” Install Claude Desktop

The MCP connector runs through the desktop version of Claude.

If Claude Desktop is not already installed:

  • Download the version corresponding to your operating system
  • Install the application
  • Launch Claude Desktop

The setup process works the same way on both macOS and Windows.


Step 6 โ€” Locate the Claude Configuration File

Claude Desktop stores MCP configuration settings in a local configuration file.

To access it:

  1. Open Claude Desktop
  2. Go to Settings
  3. Select the Developer tab
  4. Click Edit Config

This action opens the configuration file on your computer. The file is typically named:

claude_desktop_config.json

You can edit it using:

  • VS Code
  • Any code editor
  • A simple text editor

Step 7 โ€” Insert the MCP Connector Snippet

The plugin documentation provides a configuration snippet for Claude Desktop.

Copy the snippet and paste it into the configuration file inside the appropriate section, typically within the connectors array.

The snippet includes a field for authentication:

"jwtToken": "YOUR_TOKEN_HERE"

Replace the placeholder value with the authentication token generated earlier in the WordPress MCP plugin.

This token enables secure communication between Claude and your WordPress site.


Step 8 โ€” Fix the Log File Configuration

The configuration snippet includes a log file parameter.

By default, the field may contain a placeholder similar to:

optional path to log file

If left unchanged, this value may cause Claude Desktop to produce errors.

Replace the log file value with:

/dev/null

This disables log file output and prevents startup issues.


Step 9 โ€” Save and Restart Claude Desktop

After editing the configuration file:

  1. Save the file
  2. Close the editor
  3. Fully quit Claude Desktop
  4. Restart the application

It is important to completely close the application before relaunching it so the MCP configuration loads correctly.


Step 10 โ€” Activate the WordPress MCP Connector

Once Claude Desktop restarts, the WordPress MCP connector should appear automatically.

To activate it:

  1. Open Claude Desktop
  2. Create a new conversation
  3. Click the connector menu
  4. Select WordPress MCP
  5. Enable the connector

If the configuration is correct, Claude is now connected to your WordPress site.


Step 11 โ€” Verify the Connection

To confirm that the connection is working correctly, perform a simple request.

For example, ask Claude to retrieve information from WordPress.

When Claude attempts to access a WordPress tool for the first time, you will see a permission prompt requesting approval.

Authorize the request to allow Claude to execute the tool.

If everything is configured properly, Claude will successfully access WordPress data.

How the WordPress MCP Tools Work?

Once connected, WordPress exposes several MCP tools that Claude can use programmatically.

Examples of available tools include:

  • Post retrieval tools
  • Post creation tools
  • Content update tools
  • WordPress resource queries

These tools act as a structured interface between the AI model and the WordPress API.

Instead of manually interacting with the WordPress dashboard, Claude can operate through these tools using MCP commands.

Troubleshooting Common Issues

If the connector fails to appear or produces errors, verify the following:

  • The authentication token was copied correctly
  • The configuration file was saved
  • Claude Desktop was restarted after editing
  • The log file path was replaced with /dev/null
  • The plugin settings enabled MCP functionality

Most connection errors come from incorrect token placement or leaving the default log file configuration unchanged.

Final Thoughts

Connecting Claude to WordPress through MCP creates a powerful bridge between AI and content management systems. By installing the WordPress MCP plugin, generating an authentication token, and configuring Claude Desktop correctly, you establish a secure and functional integration.

The setup process requires only a few steps but unlocks a direct communication channel between Claude and your WordPress site.

Once the connection is operational, Claude can interact with WordPress through structured MCP tools, allowing advanced automation and AI-assisted workflows directly inside your content infrastructure.

alex morgan
I write about artificial intelligence as it shows up in real life โ€” not in demos or press releases. I focus on how AI changes work, habits, and decision-making once itโ€™s actually used inside tools, teams, and everyday workflows. Most of my reporting looks at second-order effects: what people stop doing, what gets automated quietly, and how responsibility shifts when software starts making decisions for us.