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.
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.
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 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.
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.
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.
Working in Elementor? The Elementor MCP server page covers Claude on classic and Atomic pages. Every builder and client is on the WordPress MCP server 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, 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.
- Download the bundle from your dashboard.
Go to the MCP setup page and click Install in Claude Desktop. The dashboard mints a per-account setup code and serves the latest
.mcpbbundle. - 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.
- 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.
- 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-serverlocally, which needs Node.js 20 or newer.
- 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-wordpressinstead.) Marketplace approval is pending with Anthropic; the Personal route is the path today. - Click Install in Cowork on your dashboard.
On the MCP setup page, 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:
- Claude redeems the token automatically.
When you hit send, Claude reads the token from the prompt and calls the
respira_redeem_tokentool. 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. - 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/_npxin Terminal and reopen Cowork. - The tool ships in
@respira/wordpress-mcp-server@6.11.8and later. The plugin's.mcp.jsonpins@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 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.
- Get the site URL and a Respira key.
Open your dashboard's MCP setup page, 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 withnode -v). - 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@latestFor every site on your account, copy the setup code from the dashboard 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 - Check it loaded.
In Claude Code, run
/mcpand confirmrespira-wordpressshows up. - 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.
Claude Code says the server failed to start.
- Run
npx @respira/wordpress-mcp-server --doctorin the same shell. It flags missing env vars, bad URLs, and auth failures. - If you see
EACCESorENOENT, your Node install is the problem.node -vmust print 20 or newer. - Behind a firewall? Try
npx -y @respira/wordpress-mcp-server --setupfor 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.
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 from day one. One setup code, every site on your account. Switch sites in the same chat.
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.