Gutenberg MCP · free tier
Gutenberg MCP: build WordPress blocks with any AI agent.
Gutenberg MCP is the block editor, driven by an AI agent. WP MCP gives Claude, Cursor, and any MCP client surgical control of the WordPress block editor: insert, update, move, and duplicate blocks by position, drop in patterns, and read the block tree before acting. No page builder, no Pro license, and every edit is snapshotted first.
Free & GPL-2.0 · ships with WordPress · fully reversible
› Add a pricing section under the hero on /pricing
⛨ page blocks saved · restorable
insert-pattern "pricing-3col" at index 1
update-block heading → "Simple pricing"
✓ Done, open it in the editor, every block is native.
Discover, inspect, act
Block tools that don't guess.
Read the tree first
parse-blocks returns a post's parsed block tree, addressed by index path, with a content hash every edit must present; list-block-types and get-block-type expose the schema. The agent knows the structure before it edits.
Edit by position
add-block, update-block, move-block, duplicate-block, and remove-block operate on precise index paths, not brittle string replacement on serialized markup.
Patterns, not blank canvases
insert-pattern drops a registered pattern's markup in place, so the agent composes from real, designed building blocks.
Reversible by construction
Every write routes through the snapshot engine. Undo one block edit or a whole session from wp-admin, no separate backup step.
Prefer Elementor? Deep Elementor editing, a curated 44-widget catalog and a structural suite, is available on Pro. See Elementor MCP.
Example prompts
Talk to the editor.
Turn the last three paragraphs on /about into a two-column layout with a pull quote.
Insert the FAQ pattern above the footer on every page in the Services category.
Find the old pricing table block and replace it with the new three-tier pattern.
Frequently asked
Questions, answered.
What is Gutenberg MCP?
It is a way for AI agents to build and edit WordPress block-editor (Gutenberg) content over the Model Context Protocol. WP MCP exposes surgical block tools, insert, update, move, duplicate, and remove blocks by position, plus block patterns, so Claude or Cursor edits the same block document the editor does. Everything it builds stays fully editable.
Do I need a page builder or a Pro license?
No. Gutenberg editing is part of the free tier. Because Gutenberg ships with WordPress, this works on a stock install with no page builder and no paid plan. Elementor deep editing is the paid hook; the block editor is free.
Are block edits reversible?
Yes. Every block write is snapshotted before it runs, so a single change or a whole agent session can be restored with one click, the same safety engine that protects every WP MCP mutation.
How does the agent avoid mangling my markup?
The tools address blocks by index path and operate on the parsed block tree, not raw string replacement. The agent can read a post's block structure, inspect a block's schema, then insert or update precisely, no fragile find-and-replace on serialized HTML.
Which clients work with it?
Claude Code and Cursor connect over HTTP with a WordPress application password, and Claude Desktop uses the desktop bundle from the WP MCP Connection screen. OAuth 2.1 (PKCE, full or read-only access chosen when you approve the client) is included but ships off until the site owner switches it on. A WP-CLI stdio bridge covers local development.
Keep exploring
Gutenberg AI agent tool reference →
Every block-editor tool by name, with the index-path editing rules and what is undoable.
Elementor MCP →
Deep Elementor page-building on the Pro tier.
WordPress MCP plugin →
Install and connect your client in minutes.
WordPress MCP server →
The whole-site, self-hosted, capability-checked server.
Read next
Build a WordPress site with Claude →
A followable walkthrough: connect Claude, build three pages with real prompts, undo what you do not like.
Undo changes in WordPress →
Revisions, builder history, backups and per-change snapshots: what each one covers and how to restore.
What is an MCP server? →
Hosts, clients, tools and transports in plain language, with a WordPress site as the worked example.
Restructure a long Gutenberg post with surgical block edits →
A beginner walkthrough of reordering, rewriting and trimming a long block editor post with WP MCP, one block at a time, with every other block left byte-identical and every step undoable.
Build custom Gutenberg blocks with your AI agent →
WP MCP builds custom Gutenberg blocks from a data spec (attributes plus an HTML template), registered with register_block_type and rendered safely with no code generation and no eval.
Build with Kadence, GenerateBlocks, Spectra, Otter, and Blocksy blocks through your AI agent →
WP MCP Pro's block suite tools validate every attribute against the suite's own schema, give each block a correct unique id, rebuild the suite's cached styles, and import patterns in one undoable write.
Import block patterns from the WordPress.org Pattern Directory →
Browse the WordPress.org Pattern Directory and insert a pattern into a page in one undoable write with WP MCP Pro, images brought into your Media Library through the guarded download.