MCP server
Gutenberg MCP server, with undo on every edit.
Block-aware editing for the WordPress Block Editor. Read, write, and snapshot every core block without flattening structure.
7 days free. No card. Runs on the AI subscription you already have.
- Support
- Full
- Gutenberg tools
- Core set
- Latest release touching it
- 8.7.2
- Releases touching it
- 30
Respira is an independent MCP server. Not affiliated with, endorsed by, or sponsored by the WordPress Foundation. WordPress is a registered trademark of the WordPress Foundation.
What works today. What still needs you.
Read from the current MCP server release, first-class reads and writes across the builder structure.
Works now
- Block tree reads with
respira_read_pagereturn the actual block structure, not just rendered HTML. - Per-element writes via
respira_find_element+respira_update_elementpreserve block attributes and innerBlocks. - Full-page replacement via
respira_update_pageworks for raw HTML imports (Word doc → blocks), with snapshot rollback on every write. - Pattern, reusable block, and template-part awareness through standard WP REST endpoints.
- Custom blocks register via the same path as core blocks. If the block exposes a REST shape, Respira can edit it.
Where a human still steps in
- Block validation errors in the editor still need a human round-trip. Respira writes the markup; if the block schema rejects it on next edit, the user sees a validation prompt.
- Some block-locking patterns (locked templates, restricted block transforms) are honored at write time but not surfaced as a tool-level error yet.
- Synced patterns inserted as references update on the next page render, no live preview from the MCP side.
Hit one of these and the snapshot gives you a clean way back.
Gutenberg runs on the universal tools.
Find, update, move and remove elements, build whole pages, snapshot and roll back. Reads return the builder structure and writes keep it intact.
Three prompts you can paste right now.
Each one assumes Respira is connected to a Gutenberg site. Paste it into your AI tool and run.
-
Update a hero headline across 20 posts
For every post in the "campaign-q3" category, find the first heading block and replace its content with "Ship faster, ship calmer." Snapshot each one before the change. -
Convert a Word doc into native blocks
Read the HTML at https://drive.example.com/post.html and convert it to native Gutenberg blocks (paragraph, heading, list, image). Create a new draft post titled "Q3 product update". -
Audit image alt text across the site
List every image block on every published post or page where the alt attribute is empty. Group by post title.
More recipes, per builder, in the Prompt Book.
Connect a Gutenberg site in two minutes.
Chat apps sign in with the browser. Coding tools take one command. Anything else takes the config below.
One command
Detects Claude Code, Cursor, Codex, Windsurf and more, and writes the config.
npx add-mcp "npx -y @respira/wordpress-mcp-server"Or paste the config
Get the site URL and key from your setup page.
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": ["-y", "@respira/wordpress-mcp-server"],
"env": {
"WORDPRESS_URL": "https://yoursite.com",
"WORDPRESS_API_KEY": "respira_your_api_key_here"
}
}
}
}- Claude Desktop on macOS reads
claude_desktop_config.json, notconfig.json. - Prefer no terminal at all? Sign in with your browser from Claude, ChatGPT or Cursor.
What changed for Gutenberg lately.
The last 5 releases that mention Gutenberg, filtered from the same changelog the releases page reads.
-
- A builder without modules now tells you which tool does work. update_module on a Gutenberg table answered that module level updates are not supported and stopped there, which is true and a dead end. Eleven of the sixteen
-
- A paragraph added to a Gutenberg page was written into a different builder entirely. On a page whose last block had just been removed, the content is empty, so the per-page builder check correctly reported nothing, and t
-
- A site can now hold one design direction, and every builder obeys it. Nine new tools. wordpress_save_design_direction, wordpress_get_design_direction, wordpress_list_design_directions, wordpress_activate_design_direction
-
- Three Figma conversion skills: figma-to-divi, figma-to-bricks and figma-to-gutenberg.
-
- Bricks move, reorder and remove now operate on Bricks' real storage shape instead of assuming every builder nests the same way. Bricks stores a page as a flat list where each element points at a parent id and lists its c
Questions people ask about Gutenberg and MCP.
Is there an MCP server for Gutenberg?
Yes. Respira is an independent MCP server that reads and writes Gutenberg in its own format, with first-class reads and writes across the builder structure. It is not made by the Gutenberg team.
Which tools does it use for Gutenberg?
Gutenberg runs through the universal tools: find, update, move and remove elements, build pages, snapshot and roll back. Reads return the builder structure, and writes keep it.
What happens when the agent gets an edit wrong?
Nothing on the live page. The agent edits a copy first, you approve it inside WordPress, and every write is snapshotted with 90 days of undo.
Do i need a developer or a terminal?
No. Sign in with your browser from Claude, ChatGPT or Cursor and approve the connection once. Coding tools get a one-line command.
Does it work with a Gutenberg site that also runs WooCommerce?
Yes. The WooCommerce add-on adds 105 store tools on the same connection, with the same duplicate-first approval flow.
The other builders, same server.
Start with one site. Free for 7 days.
Maker is €9 a month after the trial. No card for the trial, and it runs on the AI plan you already have, so there is no extra AI bill.
