What is the elementor-mcp-agent MCP server?
The elementor-mcp-agent MCP server connects to one or more WordPress sites over the REST API, started with npx -y elementor-mcp-agent and a list of site credentials in an environment variable. It gives an agent 34 tools covering page edits, template export and import, backups, rollback and an optional WP-CLI route for advanced changes.
elementor-mcp-agent gives an AI agent 34 tools for managing Elementor on one or more WordPress sites: reading and editing page data, exporting and importing templates, and a backup-and-rollback path around any write.
It is built for agencies running more than one client site. A single environment variable lists every site's URL and application password, so the agent can target a specific site by its id.
What it changes in your workflow
- An agent reads a page's Elementor data and lists its widgets before proposing an edit, instead of guessing from a screenshot.
- Every write goes through a backup step first, with a restore tool if the change needs undoing.
- Two-step confirmation and automatic rollback catch invalid data before it reaches the live page.
- A WP-CLI route, reachable over SSH, covers advanced operations the REST tools do not.
Working across client sites
| elementor-mcp-agent | |
|---|---|
| Targets | Any number of sites, chosen by site id |
| Auth | WordPress application passwords per site |
| Write safety | Backup before write, two-step confirmation, rollback on invalid data |
| Bulk edits | fleet_find_replace and bulk_find_replace_site tools across pages or sites |
Who it is for
Best for
- Agencies or freelancers managing Elementor on several client sites from one agent setup.
- Safe, auditable edits where a backup and a rollback path matter more than raw speed.
- Template export and import between sites, instead of rebuilding the same section by hand.
Not for
- Divi page building rather than Elementor is a separate builder covered by the DiviOps MCP server, built specifically for Divi 5.
- Editing pages across many different WordPress page builders at once, rather than Elementor alone, is the wider job the Respira WordPress MCP server takes on.
- A lighter Elementor inspect-and-edit tool with a smaller tool count than this one's 34 is what MCP Abilities Elementor offers instead.
- Proxying agent requests into an existing Elementor site through a separate bridge process, rather than running one dedicated server, is how the EMCP Proxy connects an agent to Elementor.
Use it with UiChemy
This server edits pages that already exist in Elementor. For a brand new page from a Figma frame or an AI build, UiChemy Composer or Figma to WordPress creates the editable Elementor page first. Click Get Started on uichemy.com.
Connect Elementor MCP Agent: Manage Elementor Sites from an AI Agent to your AI client
npx -y elementor-mcp-agentCreate an application password
In each WordPress site's user profile, generate an application password for the account the agent will use.
Set ELEMENTOR_MCP_SITES
List every site as a JSON array with id, url, username and application_password, plus an optional SSH block for the WP-CLI route.
Add the server entry
Put the config above in your client's MCP settings, with command npx and args -y, elementor-mcp-agent.
Restart and pick a site
Restart your client, then address a specific site by its id when asking the agent to read or edit a page.
Client configuration
{
"mcpServers": {
"elementor": {
"command": "npx",
"args": ["-y", "elementor-mcp-agent"],
"env": { "ELEMENTOR_MCP_SITES": "[{\"id\":\"acme\",\"url\":\"https://acme.example.com\",\"username\":\"admin\",\"application_password\":\"xxxx xxxx xxxx xxxx xxxx xxxx\"}]" }
}
}
}What you can do with it
- Multi-site by designOne ELEMENTOR_MCP_SITES list covers every client site, and tools take a site id so the agent always knows which site it is touching.
- Backup before every writeA page is backed up automatically before an edit lands, with a restore tool if the result needs undoing.
- Two-step confirmationDestructive operations need a confirmation step, which cuts down on an agent committing an edit it only meant to preview.
- Automatic rollbackData that fails Elementor's own validation is rolled back instead of being written in a broken state.
- Template export and importA section or page can be exported as a template and dropped into another page or another site.
- WP-CLI escape hatchSSH-based WP-CLI tools cover plugin updates, cache flushing and search-replace jobs the REST API does not expose.
Tools it exposes
list_sites
Lists every site configured in ELEMENTOR_MCP_SITES, with its id and URL.
ping_site
Checks that a site is reachable before running an edit against it.
read_page_elementor
Reads a page's raw Elementor data so the agent can see its current structure.
list_widgets_in_page
Lists every widget on a page, for finding the one that needs an edit.
preflight_check
Validates a planned change against Elementor's own data rules before it is written.
duplicate_elementor_page
Copies a page so a change can be tried on the copy first.
export_elementor_template
Exports a page or section as a reusable Elementor template.
import_elementor_template
Imports a previously exported template into a page on the same or a different site.
wp_cli_run
Runs a WP-CLI command over SSH for operations the REST tools cannot reach.
screenshot_page
Captures a screenshot of a live page so the agent can check a change visually.
compare_screenshots
Compares two screenshots of the same page to confirm a visual change landed as intended.
bulk_find_replace_site
Runs a find-and-replace across every page on one site in a single call.
Frequently asked questions
What is the elementor-mcp-agent MCP server?
It is an MCP server that gives an AI agent 34 tools for managing Elementor on WordPress sites: reading page data, editing widgets, exporting and importing templates, and a backup-and-rollback path around every write.
How do I install elementor-mcp-agent?
Add an MCP server entry with command npx and args -y, elementor-mcp-agent, then set the ELEMENTOR_MCP_SITES environment variable to a JSON list of your sites with their own application passwords and site ids.
Does it support more than one WordPress site?
Yes. ELEMENTOR_MCP_SITES takes an array, so one running server can manage several client sites, and every tool call targets a specific site by its id instead of assuming a single install.
How does it keep edits safe?
A page is backed up before any write, destructive calls need two-step confirmation, and data that fails Elementor's own validation is rolled back automatically rather than written in a broken state.
What is the WP-CLI route for?
Some operations, such as plugin updates or cache flushing, are not exposed through the WordPress REST API. The server's WP-CLI tools reach those over SSH when a site's config includes SSH details.
Can it move a section between sites?
Yes. export_elementor_template exports a page or section as a template, and import_elementor_template applies it to a page on the same site or a different one in the configured site list.
Does it work with Claude Code?
Yes. The server is built end to end with Claude Code and is designed for Claude Desktop and other MCP clients, since it runs as a standard stdio MCP server started by npx.


