Get the plugin
WP MCP/Docs/Claude and WordPress

Claude and WordPress · connection guide

Claude and WordPress: connect Claude to your site over MCP.

To connect Claude to WordPress you need an MCP server on the site. WP MCP is a free WordPress MCP plugin for Claude that provides one, so Claude Desktop, claude.ai and Claude Code can read and edit your site, with a snapshot saved before every write. This guide covers each route and says plainly which one needs OAuth.

Free and GPL-2.0 · self-hosted · snapshot before every write

Before you start

What you need.

  • A WordPress 6.9 or newer site on PHP 8.1 or newer, with the free WP MCP plugin installed and active.
  • A WordPress user for the agent with at least the edit_posts capability (Editor or Administrator). A dedicated user is easier to audit and revoke than your own account.
  • The WP MCP, Connection screen in wp-admin. It creates the application password and shows every snippet below already filled in for your site.

Connect

3 ways to connect Claude to WordPress.

01 / Easiest

Claude Desktop: the desktop bundle

Signs in with a WordPress application password. Nothing else to install.

  1. In wp-admin open WP MCP, Connection and create an application password.
  2. Download wpmcp.mcpb from the same screen and double-click it.
  3. Enter the WordPress username and the application password when Claude Desktop asks. The bundle itself contains no credentials.

02 / Needs Node.js

Claude Desktop: the config file

Signs in with an application password, through the mcp-remote bridge.

  1. Claude Desktop's claude_desktop_config.json only runs local servers, so an entry with a url is skipped. Use the mcp-remote bridge entry below instead.
  2. Merge it under mcpServers, with the Base64 of username:application-password in env.
  3. Fully quit and reopen Claude Desktop.

claude_desktop_config.json

{
  "mcpServers": {
    "wpmcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-site.com/wp-json/mcp/wpmcp-server", "--header", "Authorization:${WPMCP_AUTH_HEADER}"],
      "env": { "WPMCP_AUTH_HEADER": "Basic BASE64_OF_username:application-password" }
    }
  }
}

encode the credential

echo -n "your-username:xxxx xxxx xxxx xxxx xxxx xxxx" | base64

Keep Authorization:${WPMCP_AUTH_HEADER} without a space; the value with its space goes in env.

03 / Needs OAuth

Claude Desktop or claude.ai: a custom connector

Signs in with OAuth 2.1. It cannot send an application password.

  1. Switch OAuth on first. WP MCP ships a full OAuth 2.1 server with PKCE, but it is off by default and there is no switch for it in wp-admin: a site administrator adds one line to wp-config.php, or a filter in a plugin.
  2. Reload WP MCP, Connection. It now reports that OAuth is on and lists the discovery addresses.
  3. In Claude open Settings, Connectors, Add custom connector, and enter your endpoint as the URL. Leave the OAuth Client ID and secret empty.
  4. Click Connect, sign in to WordPress in the browser window, and approve. You choose full access or read-only at this step.

switch OAuth on

// wp-config.php, above "That's all, stop editing!"
define('WPMCP_OAUTH_ENABLED', true);

// or, from a plugin or mu-plugin
add_filter('wpmcp_oauth_enabled', '__return_true');

With OAuth off, the connector fails with the message: Couldn't register with WP MCP's sign-in service. That is the default state, not a fault.

Which client

What works best today, client by client.

The Claude clients are the most tested path and work on a default install with an application password. Clients that can only sign in with OAuth, ChatGPT among them, need OAuth switched on first: it ships off.

ClientHow it signs inSetup it needsHow well tested
Claude CodeApplication passwordOne command, or one .mcp.json entry. Works on a default install.Most tested, alongside Claude Desktop.
Claude DesktopApplication password (desktop bundle or config file). OAuth for the custom connector.Download the bundle from the Connection screen and enter the password. The custom connector needs OAuth switched on first.Most tested, alongside Claude Code.
CursorApplication passwordOne entry in .cursor/mcp.json. Works on a default install.Supported through the standard MCP config. Our own testing is done mostly with Claude clients.
ChatGPTOAuth only. It cannot send an application password.A site administrator switches OAuth on in wp-config.php (it ships off), then adds the site in ChatGPT as a custom MCP server.Works through OAuth once it is enabled. Not fully tested yet. A one-click switch is planned.

Check it

Verify the connection.

Ask Claude to call list-post-types or list-posts. A result means the connection and sign-in work. A 401 or 403 means the WordPress user lacks edit_posts, the Base64 credential is wrong, or (for the custom connector) OAuth is still off.

If it does not work

Common snags.

The connector cannot register
OAuth is off. Add the WPMCP_OAUTH_ENABLED line, or use the desktop bundle, which needs no OAuth.
The config entry is ignored
Claude Desktop skips entries with type, url or headers as not valid MCP server configurations. Use the bundle or the mcp-remote entry.
Claude lists 0 tools
Update WP MCP to the current release first; older versions sent a tool list some clients rejected. The bundle and the mcp-remote entry are working routes meanwhile.

Frequently asked

Claude and WordPress: questions, answered.

Is there a Claude WordPress plugin?

Claude connects to WordPress through an MCP server rather than a plugin made by Anthropic. WP MCP is an independent WordPress plugin that provides that server: install it on your site and Claude Desktop, claude.ai or Claude Code can work on the site through it.

How do I connect Claude to WordPress?

Install WP MCP, create an application password on its Connection screen, then either double-click the desktop bundle for Claude Desktop or run the one-line command for Claude Code. The claude.ai custom connector needs OAuth switched on in wp-config.php first.

Can Claude edit a live WordPress site safely?

It can edit it, and WP MCP makes that recoverable: every write is snapshotted first, and a single change or a whole session can be restored in one click. Risky paths such as raw database writes and file edits are off by default.

Does this work with claude.ai in the browser?

Yes, as a custom connector, on Claude plans that offer custom connectors. That route signs in with OAuth, which WP MCP ships off, so the site owner has to switch it on first.

Is connecting Claude to WordPress free?

The WP MCP plugin is free and GPL, including the snapshot and rollback engine. You need your own Claude account. WP MCP Pro adds deep page builder editing and unlimited undo history.

Can I give Claude read-only access?

Yes. With the OAuth route you choose read-only when you approve the client, and the token is then refused anything that changes the site. With an application password, use a WordPress user whose role fits what the agent should do.

Connect Claude to your WordPress site.