Designing WordPress Pages with Claude (WP Blocks Forge) | Themeisle Docs
Skip to content Designing WordPress Pages with Claude (WP Blocks Forge) WP Blocks Forge lets you point Claude at your WordPress site and have it design a real page for you — not a screenshot, not a pile of static HTML, but valid, fully editable Gutenberg blocks built directly into your theme. This guide walks you through everything: installing the plugins, connecting Claude, verifying the link, building your first page, editing it, iterating on the design, and how the global colors and fonts land in your theme Customizer.
Experimental feature. WP Blocks Forge is experimental and free for all ThemeIsle Agency customers while we gather feedback — just ask us to enable it on your account. Some details below may change as the product matures. Test on a staging site before using it on a live production site. In this article See it in action A complete WordPress site built end to end, page by page: Building a full LMS site in WordPress, from course pages to curriculum layout: Designing a contact page from scratch in about five minutes: Putting together an About page and seeing how it turns out: What is WP Blocks Forge? If you have ever asked an AI to "build a WordPress page," you have probably hit one of two walls: The tool imports static HTML into WordPress.
It might look fine on the front end, but you can't actually edit it in the block editor — the content is locked. The tool generates a bare, standalone theme that has nothing to do with the site (and theme) you already use. And even when something does land in the block editor, pasting block markup from elsewhere commonly throws the dreaded "this block contains unexpected or invalid content" / "syntax is not correct" errors.
WP Blocks Forge takes a different approach. Claude designs your page as a valid, editable Gutenberg structure that integrates with your real theme (Neve is used in our demo). The result: Every text, link, icon, and section is editable in the block editor — just like a page you built by hand. The layout is responsive on mobile out of the box . The global colors and fonts Claude generates are imported into your theme Customizer as real, editable WordPress defaults.
There are no "invalid block" errors — the output is valid block markup by design, because every page is checked before it's written to your site. In short: you get a designed, theme-integrated page that behaves like a native WordPress page — because it is one. Before you start / Requirements You'll need: A ThemeIsle Agency account. WP Blocks Forge is a free, experimental feature for ThemeIsle Agency customers.
Sign in at your ThemeIsle store account . Blocks Forge enabled on your account. It's free and enabled on request — see Get access & give feedback below, or just ask us via our contact form . A WordPress site you control. You need admin access to install plugins. The site must be publicly reachable over HTTPS (see the note below). An MCP-compatible Claude client. This works in claude.ai (web "co-work"), Claude Code , or any other MCP-compatible client.
Your WordPress site must be reachable from the internet over HTTPS. If you're working on a local site (for example localhost , 127.0.0.1 , a private IP, or a .local / .test / .lndo.site / .ddev.site host), the Blocks Forge cloud can't reach it. Expose it first with a tunnel such as ngrok, Cloudflare Tunnel, Tailscale Funnel, or your managed host's public preview URL. Step 1 — Install the plugins Two pieces make this work: the WP Blocks Forge plugin, plus one feature toggle inside Otter.
1. The WP Blocks Forge plugin This is our own plugin, and it's all you need for connectivity. It bundles the official WordPress MCP adapter , so there's no separate MCP plugin to install — this one plugin both lets Claude communicate with your site and integrates it with the Blocks Forge cloud, turning a design into real blocks on your site. Download blocks-forge-wp-ability.zip directly from our public GitHub repo, Codeinwp/blocks-forge-public — it isn't on WordPress.org yet. (No account is required just to download and install the plugin.) In WordPress, go to Plugins → Add New → Upload Plugin , choose the ZIP, install, and activate.
On WordPress 6.9+ the underlying Abilities API is built into core. On older versions the adapter bundled with the plugin handles everything — you don't need to install anything else for the connection. 2. Otter Blocks + the Atomic Wind feature Otter Blocks is ThemeIsle's blocks plugin and the channel Claude uses to produce the design. Install Otter Blocks from WordPress.org or themeisle.com, then activate it. In Otter → Settings , enable the Atomic Wind blocks feature.
Atomic Wind brings Tailwind-styled layout primitives into your block templates — this is the toolkit Claude mainly builds your page from. It's a small set of primitive blocks — Box, Icon, Image, Link, Text — that everything else is composed from, which is what keeps the output reliable and valid in the block editor. Atomic Wind is used for page content . Headers, footers, and blog post content are handled through your theme's settings and core Gutenberg blocks.
For more on Atomic Wind, see the Atomic Wind Blocks doc. Recommended theme: Neve We recommend Neve for the full experience. With Neve, the global colors and typography Claude generates are imported into the Theme Customizer as real, editable defaults (see Theme Customizer integration ). Your own theme will still work — you just get the deepest Customizer integration with Neve. Step 2 — Enable Blocks Forge & get your MCP address Once Blocks Forge has been enabled on your ThemeIsle store account, a new Blocks Forge section appears in your store dashboard .
Open the Blocks Forge section in your store dashboard. Find your site in the list. If it isn't there yet, create an application password on your WordPress site first. An application password is a separate login key that WordPress generates for outside services — it is not your normal WordPress password. Log in to your WordPress dashboard with an administrator account — this is the account Blocks Forge will act as on your site.
Go to Users → Profile and scroll to the Application Passwords section. Enter a name such as Blocks Forge and click Add New Application Password . Copy the password WordPress shows. It is displayed only once. Back in the Blocks Forge section, click Add Website and fill in: Website REST API URL — your site address followed by /wp-json , for example https://example.com/wp-json . WordPress username — the username of the account you created the application password for.
Application password — the password you just copied. Click Add Website to save. Your site now appears in the list. Copy the MCP URL shown in the Authentication panel — you'll paste it into Claude in the next step. The application password connects Blocks Forge to your WordPress site. It is separate from the Claude approval in Step 3, which connects Claude to your ThemeIsle account. Both are needed. If you don't see the Blocks Forge section, your account hasn't been enabled yet.
Request access via our contact form . Step 3 — Connect Claude You add Blocks Forge to Claude as a custom connector. This works in claude.ai, Claude Code, or any other MCP-compatible client. In claude.ai (web) Go to Settings → Connectors . Click Add custom connector . Paste the MCP URL you copied in Step 2. Name it Blocks Forge . Click Add , then click Connect . Claude runs a quick authorization handshake that verifies you against your ThemeIsle store account — this confirms both your identity and that Blocks Forge is enabled for you.
Approve when prompted, then return to Claude. Your connection is live. In Claude Code Add Blocks Forge as a custom/remote connector following Claude Code's connector flow, using the same MCP URL. The authorize-and-approve step works the same way. You'll never be asked to paste a raw WordPress p
The rest of this page is on the live site.