How to use the Elementor MCP with Claude
Claude is the assistant Elementor demoed its MCP with, and two of the five setup tabs in Elementor are Claude's. This guide walks through Claude Code and Claude Desktop end to end, explains where claude.ai stands, gives a safe sequence of first prompts, and lists the fixes for when Claude can't see your site.
This guide is about Elementor's official MCP (Elementor 4.3+). The plugin sold on this site has its own MCP server and its own setup, covered in Connect your AI assistant. Elementor® is a trademark of Elementor Ltd.; this site is not affiliated with Elementor.
Which Claude app should you use with the Elementor MCP?
Claude Code if you can use a terminal; Claude Desktop if you'd rather stay in a chat window.
| Claude app | Works with the official Elementor MCP? | How it connects |
|---|---|---|
| Claude Code | Yes — Elementor's default tab | Direct HTTP, with the header stored in ~/.claude.json |
| Claude Desktop | Yes — its own tab | Local bridge npx mcp-remote; Node.js required |
| claude.ai (web) and the mobile app | Not documented by Elementor | Custom connectors are added by URL and sign-in (OAuth); header authentication is reportedly in limited beta |
Claude Code has a practical edge for page building: it can read your brand guidelines, mockups and copy straight from a project folder, and keep notes between sessions. Claude Desktop is simpler if you never open a terminal.
How do you connect Claude Code to the Elementor MCP?
Enable MCP access in WordPress, pick the Claude Code tab, then let the prompt configure Claude Code — or run one command yourself.
- In WordPress, go to Elementor > Elementor MCP, click Enable MCP access and turn on agent access. You need an administrator account, WordPress 6.9+ and Elementor 4.3+ (details in the complete guide).
- Stay on the Claude Code tab, tick the acknowledgement box, then click Generate Prompt and Copy prompt.
- Either paste the prompt into Claude Code — it adds the server to
~/.claude.jsonitself — or open Prefer manual configuration? and run the command below with the values Elementor shows you. - Restart Claude Code, then check the connection.
Terminal
claude mcp add --transport http --scope user my-site-elementor \
https://your-site.com/wp-json/elementor/mcp/ \
--header "Authorization: Basic BASE64"my-site-elementor is the server name Elementor generates, and BASE64 your username and application password encoded together; copy both from Elementor's screen.
Which scope should you use?
Claude Code stores a server in one of three scopes. local (the default) makes it available in the current project only; user makes it available in every project, which suits a site you work on often; project writes it into a .mcp.json file at the project root, meant to be shared through version control.
Never use the project scope with an application password in the header: .mcp.json is designed to be committed, and the password would end up in your repository.
Check that Claude Code sees the server
Terminal
claude mcp list
claude mcp get my-site-elementorThe server should be listed as connected. Inside a session, type /mcp to see its status and tools. Then ask: “List the tools available on the Elementor MCP server.”
How do you connect Claude Desktop to the Elementor MCP?
Install Node.js, paste Elementor's block into Claude Desktop's configuration file, and restart the app.
- Install a current LTS version of Node.js: Claude Desktop reaches the site through
mcp-remote, started withnpx. - In WordPress, pick the Claude Desktop tab on the Elementor MCP page and generate the prompt — or open Prefer manual configuration? to copy the block directly.
- In Claude Desktop, open Settings > Developer > Edit Config. This opens
claude_desktop_config.json(in~/Library/Application Support/Claude/on macOS,%APPDATA%\Claude\on Windows). - Paste the block inside
mcpServers— next to any servers already there — and save. - Quit Claude Desktop completely and reopen it: the server list is only read at startup.
claude_desktop_config.json
{
"mcpServers": {
"my-site-elementor": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://your-site.com/wp-json/elementor/mcp/",
"--header", "Authorization: Basic BASE64"]
}
}
}On Windows, mcp-remote can split the header at its space. If the server fails to start, use the environment-variable version in the complete guide.
Can you use the Elementor MCP from claude.ai or the Claude mobile app?
Not in any documented way, as of 9 October 2026 — and we haven't tested it.
claude.ai and the mobile app reach MCP servers through custom connectors: you paste a URL, Anthropic's servers connect to it, and you normally sign in through OAuth. The official Elementor MCP offers no sign-in — only an application-password header — and Elementor doesn't list claude.ai as a client. Header authentication for custom connectors is reported to be in a limited beta, for some organisations only. Either way, your site has to be reachable from the internet: a local development site can't be used this way.
If you need Claude on the web or on your phone, look at third-party Elementor MCP servers that support OAuth; our comparison lists which ones do.
Which prompts should you try first?
Read before you write: three read-only prompts, then one build in a draft, then one edit.
Elementor's own documentation recommends the same order to the AI: read the site's resources, set up variables and classes, fetch widget schemas, then build — with a dry run first — and use small edits for follow-ups. Asking for it explicitly gives better results.
- “List the tools available on the Elementor MCP server.”
- “Read the structure of the page Home and summarise its sections.”
- “List the global variables and classes defined on this site, and tell me which ones look like brand colours and type sizes.”
- “Create a new draft page called Services: a hero with an H1, a subtitle and one button, a grid of three service cards, and a contact call to action. Reuse the site's existing variables and classes instead of hard-coded values. Do a dry run first, show me the plan, then build it.”
- “On the Services page, stack the cards on mobile and reduce the H1 size on tablet.”
Then open the page in the Elementor editor and review it like any other draft before you publish.
Tips for better pages with Claude
- Give it context once: brand colours, tone, target audience, the pages that already exist. In Claude Code, keep this in a project file Claude can read.
- Build in stages: one section per request goes further than a whole page in one prompt, and errors stay small.
- Ask for tokens, not values: “use the existing variables and classes” keeps the page consistent with the rest of the site.
- Let it check its own work: the MCP can create a temporary preview link; if Claude also has a browser tool, it can open that link and compare the result with your mockup.
- Close the page in the editor while Claude works on it, or you'll hit Elementor's conflict warning.
What do you do when Claude can't see the Elementor MCP?
Find out which side fails first: Claude's configuration, the credentials, or the host.
| Symptom | Likely cause | Fix |
|---|---|---|
Server missing from claude mcp list | Added in another scope or project, or a typo in ~/.claude.json | Re-add it with --scope user, and check the JSON is valid. |
| “Failed to connect” | Wrong URL, no HTTPS, or credentials refused | The URL must end in /wp-json/elementor/mcp/. Test it with the curl command below. |
| “Connected · tools fetch failed” | A schema bug reported during the beta (GitHub issue #37320, still open) | Update Elementor to the latest 4.3.x; if it persists, add your details to the issue. |
| Times out after about 30 seconds | Open issues where some requests hang on certain hosts | Update Elementor, try a staging copy on another host, and follow the GitHub issues in Sources. |
| Claude Desktop: server shows as failed | Node.js missing or outdated, or the header split on Windows | Install Node.js LTS, read the MCP logs (below), and use the Windows workaround if needed. |
| Claude answers without using any Elementor tool | Tools disabled in the conversation, or an old conversation | Start a new conversation and check the server is enabled in the tools menu. |
401 or rest_not_logged_in | The host strips the Authorization header | Add the .htaccess rule from the complete guide. |
Test the endpoint without Claude
This request does what Claude does first. A 200 response that mentions the server means the site and credentials are fine and the problem is on Claude's side; a 401 points to the password or the header.
Terminal
curl -i -X POST https://your-site.com/wp-json/elementor/mcp/ \
-H "Authorization: Basic BASE64" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'Read Claude Desktop's MCP logs
On macOS, the logs live in ~/Library/Logs/Claude/; on Windows, in %APPDATA%\Claude\logs.
macOS
tail -n 50 -F ~/Library/Logs/Claude/mcp*.logUsing Claude with a third-party Elementor MCP server
The steps are the same with a different URL and credentials.
Third-party Elementor MCP plugins each expose their own endpoint on your site. The plugin sold here, for instance, answers at https://your-site.com/wp-json/elementor-mcp-createur/mcp through OAuth sign-in from claude.ai and the mobile app, or with a dedicated MCP_ELEMENTOR user and its application password from Claude Code and Claude Desktop; both setups are in Connect your AI assistant. You can run it next to Elementor's official MCP — give each server its own name in Claude's configuration.
Elementor MCP and Claude: frequently asked questions
Do I need a paid Claude plan to use the Elementor MCP?
Claude Code needs a paid Claude plan or an Anthropic API account. Plans change often, so check Anthropic's pricing page before you start. The Elementor side of the connection is free.
Claude Code or Claude Desktop for Elementor?
Claude Code if you're comfortable in a terminal: it connects directly and can read mockups and brand files from your project. Claude Desktop if you prefer a chat window; it needs Node.js for the local bridge.
Is my application password sent to Anthropic?
If you paste Elementor's setup prompt into Claude, yes: the prompt, password included, becomes part of the conversation. With manual configuration, the password stays in a file on your computer and is only sent to your own site.
Can Claude build a page from my mockup?
Yes, if you attach the image and describe the page: Claude reads the mockup and builds Atomic elements through the MCP. Ask it to reuse your variables and classes, build section by section, and check the preview link.
Why does Claude say it can't edit a section?
The section is probably built with classic (V3) widgets. The official MCP only modifies Atomic (V4) elements, apart from a few theme widgets.
Where to go next
Sources
- Elementor Help — How to connect Elementor to an AI tool using MCP
- Elementor Help — How to build and edit your site using Elementor MCP
- Elementor docs — MCP abilities and recommended call order
- Claude Code — Connect Claude Code to tools via MCP
- Model Context Protocol — Debugging (Claude Desktop logs)
- mcp-remote — README
- GitHub — elementor/elementor issue #37320 (tools fetch failed)
- GitHub — elementor/elementor issue #37516 (requests hanging)
- GitHub — elementor/elementor issue #37607 (initialize timeout)