# Claude + WordPress: every way to connect them | Respira

> Connect Claude to WordPress from claude.ai, Claude Desktop, Claude Code or Cowork, plus the Claude plugin and skills. Edits land on a copy, with undo.

Source: https://www.respira.press/integrations/claude

---

To connect Claude to WordPress, install the Respira for WordPress plugin on the site and add the site to Claude: as a custom connector by its link in claude.ai or Claude Desktop, with one command in Claude Code, or with the Respira plugin in Claude Cowork. Claude then reads and edits your pages through Respira's MCP server, in the page builder each page was made with. Every edit lands on a copy first, you approve it, and you can undo it for 90 days.

## Every way to connect Claude to WordPress

### claude.ai: a custom connector with the site link

In claude.ai, open Settings, Connectors, Add custom connector, and paste your site's MCP link: your address followed by /wp-json/respira/v1/mcp, or copy it from your dashboard's MCP setup page. Sign in to Respira and approve once. No key to paste and no file to download.

[Connect claude.ai or Claude Desktop by link](https://www.respira.press/docs/connect-claude-desktop-oauth) 

### Claude Desktop: the same link, or a bundle for every site

Claude Desktop takes the same custom connector and sign-in as claude.ai. For every site on your account at once, install the Respira bundle and paste the setup code from your dashboard.

[Bundle steps below](#desktop) · [Connector guide](https://www.respira.press/docs/connect-claude-desktop-oauth) 

### Claude Code: one command

Run claude mcp add with Respira's MCP server, the command from your dashboard's MCP setup page, which already holds your site URL and key (it needs Node.js 20 or newer), or with a setup code that covers every site. Or add the site's MCP link with claude mcp add --transport http respira and sign in in the browser, with no key.

[Claude Code steps below](#code) · [The Claude Code guide](https://www.respira.press/blog/claude-code-wordpress) 

### Claude Cowork: the Respira plugin

Add the Respira plugin in Cowork from its repository, then connect every site with a one-time code from your dashboard. The plugin brings slash commands for the common edits.

[Respira for Claude Cowork](https://www.respira.press/cowork) · [Cowork steps below](#cowork) 

### The Claude plugin: Cowork and Claude Code

The same Respira plugin for Claude runs in Cowork and in Claude Code, with 8 slash commands and 57 skills. It is not in Anthropic's plugin directory yet; it installs from the repository.

[About the plugin](https://www.respira.press/cowork) · [The plugin on GitHub](https://github.com/respira-press/cowork-plugin-wordpress) 

### Skills: WordPress know-how for Claude

Skills are instructions Claude loads when a task matches them: audits, migrations, SEO, accessibility. The Respira skills marketplace is free and open source, and runs in Claude Code and the other agents that read skills.

[WordPress skills for Claude Code](https://www.respira.press/skills) 

Working in Elementor? The [Elementor MCP server](https://www.respira.press/elementor-mcp) page covers Claude on classic and Atomic pages. Every builder and client is on the [WordPress MCP server](https://www.respira.press/mcp) page. 

Claude connects to your WordPress sites through Respira's MCP server: a custom connector by the site's link in claude.ai or Claude Desktop, a bundle for Claude Desktop, a plugin for [Claude Cowork](https://www.respira.press/blog/claude-cowork-launch), one command for Claude Code. Once connected, Claude reads and edits pages in their own page builder, on a copy first, with 90 days of undo.

1. **Download the bundle from your dashboard.**  
Go to [the MCP setup page](https://www.respira.press/dashboard/mcp) and click *Install in Claude Desktop*. The dashboard mints a per-account setup code and serves the latest `.mcpb` bundle.  
[Open dashboard setup](https://www.respira.press/dashboard/mcp) [Or grab the bundle directly ](https://www.respira.press/downloads/respira-wordpress-latest.mcpb)
2. **Double-click the downloaded file.**  
Claude Desktop opens and walks through a one-click install prompt. You can review what the server does before approving.
3. **Paste the setup code when Claude asks.**  
The setup code maps Claude Desktop to every WordPress site connected to your Respira account. It is stored in your operating system keychain, never in plain text. If you rotate a site token later, re-run the install step to refresh the code.
4. **Ask Claude to do something.**  
Try: *list my sites*. Then: *duplicate the homepage on site A and change the hero headline to X*. The first write lands as a duplicate draft, so nothing on the live site changes until you approve it.
Claude Desktop did not open the bundle. 
- Make sure Claude Desktop is installed and up to date. The .mcpb handler ships with recent builds.
- On macOS, right-click the file and choose *Open* the first time if Gatekeeper blocks it.
- If nothing happens, open Claude Desktop, go to Settings, and drag the .mcpb file in manually.
- Corporate firewall? The bundle runs `npx @respira/wordpress-mcp-server` locally, which needs Node.js 20 or newer.

1. **Install the Cowork plugin.**  
In Claude Cowork, open *Customize → Plugins*, click the *Personal* tab, then *\+ → Add marketplace → Add from a repository* and enter `respira-press/cowork-plugin-wordpress`. Click *Sync*, then *Install*, and *Continue* on the "local MCP servers" notice. (On Claude Code, run `/plugin marketplace add respira-press/cowork-plugin-wordpress` instead.) Marketplace approval is pending with Anthropic; the Personal route is the path today.  
[Open plugin on GitHub ](https://github.com/respira-press/cowork-plugin-wordpress) [About the plugin](https://www.respira.press/cowork)
2. **Click Install in Cowork on your dashboard.**  
On [the MCP setup page](https://www.respira.press/dashboard/mcp), pick *Claude Cowork*. In step 2, *Connect Cowork*mints a one-time setup token (5-minute TTL) and gives you two ways to deliver it:  

  - **Open in Cowork**: fires a `claude://cowork/new` deeplink. Your browser opens a fresh Cowork chat with the setup prompt pre-filled in the composer. Hit send.
  - **Copy setup prompt**: copies the prompt to your clipboard. Paste into any existing Cowork chat where the plugin is installed and hit send. Useful when your browser blocks the `claude://` scheme.  
[Open dashboard setup](https://www.respira.press/dashboard/mcp)
3. **Claude redeems the token automatically.**  
When you hit send, Claude reads the token from the prompt and calls the `respira_redeem_token` tool. The MCP server hits the redeem endpoint, exchanges the token for your full sites + keys, and writes the canonical config to `~/.respira/config.json`. You'll see a "connected to N sites" message. From there, every Respira tool is reachable.
4. **Use the bundled slash commands.**  
Cowork plugin ships with 8 commands: `/respira:connect-site`, `/respira:edit-page`, `/respira:duplicate-page`, `/respira:preview-changes`, `/respira:undo-last-change`, `/respira:audit-site`, `/respira:add-section`, `/respira:help`. Plus 57 auto-activating skills (mobile audit, technical-debt scan, SEO + AEO, builder migrations, image optimization, and more).
Claude says it can't find `respira_redeem_token`. 
- Your npx cache may be holding an older MCP server build. Run `rm -rf ~/.npm/_npx` in Terminal and reopen Cowork.
- The tool ships in `@respira/wordpress-mcp-server@6.11.8` and later. The plugin's `.mcp.json` pins `@latest`, so a fresh npx fetch should pull it.
- If the MCP server still won't start, check `~/.respira/last-startup-error.txt`, the server writes the actual failure there.
The deeplink doesn't open Cowork. 
- Your browser may block the `claude://` scheme on first run. Look for a one-time prompt asking to allow Claude to handle the URL.
- Copy the setup prompt instead and paste it into a Cowork chat where the plugin is installed.
- Mac and Linux fallback: [download config.json](https://www.respira.press/api/mcp/config/export?client=cowork) directly and save it to `~/.respira/config.json`. On Windows a file on the C: drive is invisible to Cowork's sandbox; install the Claude Desktop extension instead.

1. **Get the site URL and a Respira key.**  
Open [your dashboard's MCP setup page](https://www.respira.press/dashboard/mcp), pick Claude Code and copy the command: it already holds the URL and a key. To make a key by hand instead, open **Respira › Settings › API keys & MCP** in wp-admin and choose **New key**. A key starts with `respira_`. The server runs on your machine through npx and needs Node.js 20 or newer (check with `node -v`).
2. **Add the MCP server.**  
Run this in any shell, with your URL and key in place of the examples:  
`claude mcp add respira-wordpress --env WORDPRESS_URL=https://yoursite.com --env WORDPRESS_API_KEY=respira_your_api_key_here -- npx -y @respira/wordpress-mcp-server@latest`  
For every site on your account, copy the setup code from [the dashboard](https://www.respira.press/dashboard/mcp) and pass it as one variable instead:  
`claude mcp add respira-wordpress --env RESPIRA_CONFIG_B64=your_setup_code -- npx -y @respira/wordpress-mcp-server@latest`
3. **Check it loaded.**  
In Claude Code, run `/mcp` and confirm `respira-wordpress` shows up.
4. **Ask Claude Code to edit a page.**  
Try: *using respira-wordpress, list the most recently edited pages on my site*.

The full walkthrough, from this command to a first edit on a draft copy and its undo, with Elementor, Divi and Bricks notes: [Connect Claude Code to WordPress](https://www.respira.press/blog/claude-code-wordpress).

Claude Code says the server failed to start. 
- Run `npx @respira/wordpress-mcp-server --doctor` in the same shell. It flags missing env vars, bad URLs, and auth failures.
- If you see `EACCES` or `ENOENT`, your Node install is the problem. `node -v` must print 20 or newer.
- Behind a firewall? Try `npx -y @respira/wordpress-mcp-server --setup` for a guided config instead.
- If the server starts but the site refuses it, open **Respira › Troubleshoot** in wp-admin. It runs the connection checks from the site's own server, names what is in the way (a stripped Authorization header, a bot filter, a challenge page) and writes a report for your host. A host that strips Authorization is covered on its own: the server sends the credential a second way and the plugin reads that copy.
- Still stuck? Open the Claude Code MCP log panel and paste the first error line into [support](https://www.respira.press/support).

## Things to ask Claude, once it is connected

- list my connected sites and which page builder each one runs
- on site A, duplicate the homepage and change the hero headline to "book a visit"
- find every page that still says "2024" and update to "2025" across the site
- scan the pricing page for accessibility issues and tell me what needs fixing
- show me the last 10 changes on site B. if any broke the live site, roll them back
- draft SEO titles for the five most recent blog posts and let me approve each before saving
- create a duplicate of the about page in a new language and translate the headings

Every write lands as a duplicate or draft first. You approve before anything touches the live site. 

## Why this is worth the install

- **19 page builders supported.** Elementor, Divi, Bricks, Gutenberg, WPBakery, Beaver Builder, Oxygen, Breakdance, Brizy, Thrive Architect, Visual Composer, Flatsome, YOOtheme Pro, Avada, Spectra, Kadence Blocks, GenerateBlocks, SeedProd.
- **300+ tools.** Full read/write across posts, pages, ACF, menus, media, plugins, menus, taxonomies, Woo catalog.
- **Duplicate-before-edit by default.** Every write is snapshotted. Rollback is one sentence.
- **[Multi-site](https://www.respira.press/blog/connect-multiple-wordpress-sites) from day one.** One setup code, every site on your account. Switch sites in the same chat.

[Set up in the dashboard](https://www.respira.press/dashboard/mcp) [Pricing](https://www.respira.press/pricing) 

## Claude and WordPress: questions people ask

How do I connect Claude to WordPress? 

Install the Respira for WordPress plugin on the site, then add the site to Claude. In claude.ai or Claude Desktop, add a custom connector with the site's MCP link and approve it once in the browser. In Claude Code, run the one claude mcp add command your dashboard's MCP setup page gives you, with your site URL and key already in it. In Claude Cowork, install the Respira plugin and connect your sites with a one-time code. Claude then reads and edits pages in their own page builder, on a copy first, with 90 days of undo.

Is there a Claude WordPress plugin? 

There are two pieces, both called plugins. Respira for WordPress is the WordPress plugin on your site that Claude talks to. The Respira plugin for Claude runs in Claude Cowork and Claude Code and adds 8 slash commands and 57 skills. You need the first for every way in; the second is optional and lives in Claude.

What is the Claude WordPress MCP? 

MCP, the Model Context Protocol, is how Claude calls outside tools. A WordPress MCP server turns a site into tools Claude can use: list pages, read a page, change a heading, take a snapshot, undo. Respira's MCP server lives at your site address followed by /wp-json/respira/v1/mcp. The WordPress project's own MCP Adapter also connects Claude, exposing whatever abilities plugins register, without a copy-first edit or undo of its own.

Are there Claude skills for WordPress? 

Yes. The Respira skills marketplace at respira.press/skills has free, open-source WordPress skills for audits, migrations, SEO, accessibility and more, for Claude Code and other agents that read skills. The Respira plugin for Claude bundles skills too, and they activate when the conversation matches them.

Can Claude edit Elementor pages in WordPress? 

Yes. Through Respira, Claude reads and writes Elementor's classic widgets and Atomic elements in Elementor's own format, with Site Settings colours and fonts kept linked, and every edit lands on a copy you approve. Elementor's own MCP, from Elementor 4.3, also connects Claude and edits Atomic pages. The comparison is on the Elementor MCP server page at respira.press/elementor-mcp.

Is there a setup wizard for WordPress and Claude Code? 

Yes. Run npx @respira/wordpress-mcp-server --setup in a terminal. The interactive wizard saves which WordPress sites the server can reach to \~/.respira/config.json, then prints a command, npx add-mcp, that adds the server to Claude Code and other tools, and the JSON entry if you prefer to paste it. The single-command route, claude mcp add, works without it. Either way the server needs Node.js 20 or newer.

Can I use Claude Cowork with WordPress? 

Yes. Add the Respira plugin in Cowork under Customize, Plugins, Personal, from the repository respira-press/cowork-plugin-wordpress, then connect every site with a one-time code from the Respira dashboard. Cowork needs Node.js on your computer for the plugin's server. On Windows, also install the Claude Desktop extension for a setup that lasts.

Does claude.ai work, or do I need Claude Desktop? 

claude.ai works in the browser: Settings, Connectors, Add custom connector, paste the site's MCP link, sign in to Respira and approve. Claude Desktop uses the same connector, and also takes a bundle that covers every site on your account.
