The open-source Elementor MCP Server for WordPress. Connect Claude, ChatGPT, Codex, Cursor, and other AI agents to Elementor to build, edit, inspect, and automate WordPress websites through the Model Context Protocol (MCP).
Documentation | Installation | Features | Examples | AI client setup | Pro
Build and manage Elementor websites with Claude, ChatGPT, Codex, Cursor, and other MCP-compatible AI agents.
- Open source: GPL-2.0-or-later WordPress plugin with public source, tests, release workflows, and checksums.
- WordPress MCP Server: Typed content, media, settings, diagnostics, and controlled administration workflows.
- Elementor MCP: 41 Elementor Core abilities included in Free.
- Production-safe permissions: WordPress capabilities, typed schemas, safety profiles, rate limits, and explicit confirmations.
- Change evidence and rollback: Redacted before and after evidence with verified rollback where the operation supports it.
- Elementor 4 support: Compatible Atomic Elements, Global Classes, and Variables when the installed Elementor version exposes them.
- Prompt library: 10 detailed Free industry prompts and more than 300 specialized Pro prompts.
Install the attached
elementor-mcp.ziprelease asset. GitHub's automatically generated "Source code" archives are development snapshots, not installable WordPress plugin packages.
Elementor MCP applies the Model Context Protocol for WordPress and the Model Context Protocol for Elementor through a typed, permission-aware server. It can be used as an AI Elementor builder, an AI WordPress builder, an Elementor automation layer, or a WordPress automation layer without giving an agent unrestricted access by default.
flowchart LR
A["Claude, ChatGPT, Codex, Cursor"] --> B["Elementor MCP Server"]
B --> C["Typed abilities and WordPress permissions"]
C --> D["WordPress and Elementor"]
D --> E["Draft, preview, verify, and record evidence"]
The AI client discovers the abilities available to its authenticated WordPress user, reads live schemas, inspects the current document, performs the approved operation, and returns structured evidence. The active safety profile can block the operation before execution.
Give your connected AI agent this request:
Build a premium SaaS landing page in Elementor with a hero, product workflow,
features, pricing, proof, FAQ, and final CTA. Create a coherent design system,
use native Elementor containers and widgets, keep the page as a draft, and
verify desktop, tablet, and mobile behavior before asking for publication.
The expected path is:
- Claude, ChatGPT, Codex, Cursor, or another client discovers the live tools.
- Elementor MCP checks the WordPress user, safety profile, and input schema.
- The agent inspects the site, theme, Elementor version, and existing content.
- The agent creates or edits native Elementor data as a draft.
- The result is previewed and reviewed with returned change evidence.
These are realistic starting requests. Available actions still depend on the connected user's permissions, enabled abilities, safety profile, Elementor version, and installed integrations.
Build a premium seven-page website for a dental clinic using Elementor. Create
a consistent design system and reusable global styles. Use only verified
business facts and leave missing claims clearly marked for confirmation.
Inspect the current homepage and redesign the hero while preserving the
existing content, links, forms, tracking, and Elementor editability.
Audit this Elementor page for tablet and mobile problems. Explain the issues,
fix approved layout and overflow defects, and verify representative widths.
Inspect this component and convert it to compatible Elementor Atomic Elements
and reusable Global Classes without changing its visible content.
Create draft Services pages, organize the navigation structure, and assign
approved featured images. Do not publish anything until I review it.
Audit this landing page and update only the SEO metadata supported by the
installed SEO integration. Do not invent schema facts or promise rankings.
Inspect the authoritative WooCommerce catalog and create a draft Elementor
landing page for this product category. Preserve real prices, stock, product
links, shipping facts, and return terms.
Inspect the site for configuration, performance, and content problems. Explain
what should be fixed and request approval before making any changes.
Elementor MCP is designed to be the Elementor MCP Server for AI agents, not a generic adapter for every page builder. Elementor is the only page-builder integration in this repository. That focus allows the Free plugin to include a deep native workflow for documents, containers, widgets, templates, global styles, Atomic Elements, Global Classes, and Variables.
WordPress remains the foundation underneath. Content, media, taxonomies, comments, revisions, menus, settings, diagnostics, and compatible non-builder integrations remain available when their requirements are present.
The stable product identity is:
- Product: Elementor MCP
- Website: ElementorMCP.com
- GitHub:
wpFelix/elementor-mcp-server - Primary term: Elementor MCP Server
- Secondary term: WordPress MCP Server
The Free plugin registers 41 Elementor Core abilities through a shared typed runtime:
- Inspect Elementor setup, version compatibility, documents, templates, page structure, widget schemas, global styles, classes, and variables.
- Create draft pages and build native Elementor container and widget trees.
- Edit, move, duplicate, and remove elements with schema-aware operations.
- Read and apply templates and manage compatible global design settings.
- Work with Elementor 4 Atomic Elements, Global Classes, and Variables when the installed Elementor version exposes them.
- Protect Elementor-owned documents from ordinary raw WordPress content writes.
- Preview consequential operations where available, then return change evidence for review.
No alternate page-builder adapter, loader, skill, or ability is shipped.
The Free plugin also exposes a typed WordPress core surface:
- Posts, pages, supported custom post types, terms, media, comments, revisions, and navigation menus.
- User reads and carefully allowlisted WordPress settings.
- Plugin and theme search, inspection, activation, deactivation, updates, and other lifecycle operations according to the active safety profile.
- Health, configuration, performance, and scoped security diagnostics.
- MCP resources, prompts, reusable skills, design context, and controlled developer operations.
- Optional forms, SEO, custom-field, commerce, localization, and theme integrations that load only when their required modules and plugins exist.
Creation is draft-first. Publishing requires an explicit published status and the connected WordPress user's matching capability.
After activation, open Elementor MCP > Connect in WordPress. Choose the client first, then use the exact URL and authentication method generated for that site. The examples below contain placeholders and must not be copied with real secrets into a repository.
For Claude Code with an access token, the Connect screen generates a command in this shape:
claude mcp add --transport http elementor-mcp <YOUR_GENERATED_MCP_URL> --header "Authorization: Bearer <YOUR_TOKEN>" --scope userRestart Claude Code after adding the server. Claude Desktop can use the
generated claude_desktop_config.json or the guided connector flow. Claude on
the web requires a publicly reachable HTTPS site.
ChatGPT uses OAuth rather than a fixed Authorization-header field:
- Make the WordPress site reachable over public HTTPS.
- Open ChatGPT > Settings > Apps > Advanced settings.
- Enable Developer mode and choose Create app.
- Paste the OAuth MCP URL generated by Elementor MCP > Connect.
- Complete the browser consent flow with the intended WordPress account.
For Codex CLI with an access token, add the generated values to
~/.codex/config.toml on macOS or Linux, or
%USERPROFILE%\.codex\config.toml on Windows:
[mcp_servers.elementor-mcp]
url = "<YOUR_GENERATED_MCP_URL>"
[mcp_servers.elementor-mcp.http_headers]
Authorization = "Bearer <YOUR_TOKEN>"For OAuth, follow the Connect screen and run codex mcp login after adding the
server. The Codex desktop app uses its remote MCP settings and OAuth browser
sign-in.
For Cursor, add the generated access-token configuration to ~/.cursor/mcp.json
or the project's .cursor/mcp.json:
{
"mcpServers": {
"elementor-mcp": {
"type": "http",
"url": "<YOUR_GENERATED_MCP_URL>",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}Cursor can also use OAuth. Complete its browser sign-in when it reports that the server needs authentication.
The built-in registry also provides client-specific guidance for Claude Desktop, Claude on the web, VS Code, GitHub Copilot, Gemini CLI, Qwen Code, Kimi Code CLI, Factory Droid, Mistral Le Chat, Perplexity, Manus, Zed, Cline, OpenCode, and other compatible remote MCP clients.
Configuration shapes differ. VS Code nests entries under servers; Gemini CLI
and Qwen Code use httpUrl; some editors use serverUrl; and hosted web clients
require public HTTPS. Use the generated client-specific configuration instead
of changing field names by guesswork.
| Component | Requirement |
|---|---|
| WordPress | 6.9 or newer |
| PHP | 8.0 or newer |
| Elementor | 3.6 or newer for Elementor workflows |
| Remote connections | HTTPS strongly recommended and required for OAuth |
| License | GPL-2.0-or-later |
Elementor is optional for WordPress core operations. Activating a compatible Elementor version unlocks the 41-ability page-building surface.
- Download the latest stable
elementor-mcp.zip. - In WordPress, open Plugins > Add New Plugin > Upload Plugin.
- Upload
elementor-mcp.zip, install it, and activate Elementor MCP. - Install and activate Elementor if you want to use the Elementor abilities.
- Open Elementor MCP > Connect in WordPress.
- Choose your AI client and authentication method, then copy the generated connection details.
- Keep Production Safe enabled for ordinary site work.
The public release includes a matching SHA-256 checksum. Use the release asset, not GitHub's generated source archive.
| Method | Best for | Notes |
|---|---|---|
| OAuth | Modern clients with browser sign-in | Uses consent, expiring credentials, refresh tokens, revocation, and a dedicated OAuth MCP route. |
| Access token | Clients that can send a Bearer token | Tokens are shown once, stored as hashes, can expire, and can be revoked. |
| Application Password | Clients that support HTTP Basic authentication | Uses WordPress's per-user Application Password system. |
For a safe first session:
- Connect with Production Safe enabled.
- Discover the abilities available to the authenticated WordPress user.
- Read the live input schema for the target ability.
- Inspect the existing page or template before changing it.
- Preview the operation when a preview is available.
- Apply only the approved change and review its returned evidence.
The server uses the WordPress Abilities API and bundles the official WordPress MCP Adapter. It supports the documented legacy and modern MCP protocol paths while applying the same authorization and safety controls to both.
| Profile | Intended use | Mutation policy |
|---|---|---|
| Production Safe | Normal content, design, SEO, form, and commerce work | Allows ordinary operations while blocking critical developer primitives. Destructive allowed operations require explicit confirmation. |
| Read Only | Audits, discovery, reporting, and support | Blocks every mutation, including rollback. |
| Developer Full Access | Deliberate development or recovery work | Permits manually enabled critical abilities. Critical and destructive calls still require confirmation. |
Every state-changing ability is checked against the connected WordPress user's capabilities and its declared schema. The bounded change ledger redacts secrets, records before and after fingerprints, attributes writes to the agent credential, and offers rollback only for operations that can be safely verified. Irreversible actions are recorded as non-reversible.
Read the full safety model before granting development access.
Free includes exactly 10 detailed Elementor homepage prompts:
| Industry | Prompt focus |
|---|---|
| Restaurant and Cafe | Menu accuracy, dietary process, reservations, hours, location, and original food photography |
| Dental Clinic | Verified clinicians, treatments, fees, accessibility, patient process, and responsible clinical claims |
| Law Firm | Jurisdiction, named lawyers, credentials, practice areas, consultation flow, and legal disclaimers |
| Real Estate Agency | Buyer, seller, rental, listing, agent, service-area, and valuation journeys |
| Fitness Studio | Classes, trainers, facilities, schedules, memberships, accessibility, and non-misleading outcome claims |
| Home Services | Service radius, real projects, credentials, process, workmanship terms, and quote flow |
| Nonprofit and Community | Programs, sourced impact, governance, safeguarding, reports, donations, and volunteering |
| Education and Training | Curriculum, instructors, prerequisites, workload, delivery, fees, support, and outcome boundaries |
| E-commerce and Retail | Product data, media, stock, price, shipping, returns, reviews, support, and buying guidance |
| SaaS and Software | Real workflows, screenshots, integrations, security evidence, pricing, documentation, and demos |
Each prompt includes discovery, an industry fact contract, section architecture, a design system, media rules, accessibility, responsive behavior, performance, safe draft construction, verification, and handoff requirements. Missing facts must remain explicit instead of being invented by the AI client.
| Capability | Free | Pro |
|---|---|---|
| MCP transport and authentication | Included | Uses Free |
| Safety profiles, approvals, and change evidence | Included | Extended workflows use the same controls |
| WordPress core abilities | Included | Uses Free |
| Elementor Core abilities | 41 included | Uses and extends the Free runtime |
| Elementor 4 Atomic Elements, Classes, and Variables | Included when available | Extended advanced workflows |
| Industry prompt library | 10 detailed prompts | More than 300 specialized prompts |
| Advanced specification reconstruction | Not included | Included |
| Dynamic content and display conditions | Not included | Included |
| Popups, forms and submissions, custom code, interactions, and SVG upload | Not included | Included |
Elementor MCP Pro depends on the Free plugin and is not included in this public repository. See Elementor MCP Pro for the product overview.
Follow meaningful public development through the commit history, changelog, and tagged releases. Do not infer maturity from an artificial commit count; releases and commits are kept as real project history.
Tagged releases are built by GitHub Actions. The release workflow runs the repository tests and static verification, builds the dashboard assets, creates the installable plugin ZIP, and publishes its SHA-256 checksum. A passing build is repository-level evidence, not a guarantee for every hosting stack, third-party plugin combination, or production site.
Every public release should clearly identify what changed, what was improved or fixed, security or compatibility notes where applicable, the installable ZIP, its checksum, and any required upgrade steps.
Yes. Elementor MCP installs as a WordPress plugin and exposes typed WordPress abilities through the Model Context Protocol. The available operations still depend on the connected user's WordPress capabilities, enabled abilities, active safety profile, and installed integrations.
Yes. Free includes 41 Elementor Core abilities for document inspection, page building, element editing, templates, global styles, and compatible Elementor 4 Atomic features.
Elementor MCP is the governed connection layer, not the AI model. It lets a compatible AI agent for WordPress or AI agent for Elementor use typed tools under WordPress permissions and the active safety profile.
Only for Elementor-specific workflows. WordPress core, diagnostics, skills, and compatible non-builder integrations can remain available without Elementor.
Content creation defaults to draft. Publishing needs an explicit published status and the matching WordPress capability. Destructive operations that are allowed by the active profile require explicit confirmation.
Install elementor-mcp.zip from the latest GitHub Release. Do not install the
automatically generated "Source code" ZIP or tarball.
The repository contains PHP source, TypeScript dashboard source, bundled dependencies, tests, skills, prompt packs, documentation, packaging scripts, and release workflows. Run the repository verification scripts before creating a release ZIP. Do not commit credentials, production exports, or generated local state.
See CONTRIBUTING.md for contribution guidance and SECURITY.md for private vulnerability reporting.
Elementor MCP is licensed under GPL-2.0-or-later. Product documentation is available at ElementorMCP.com.