| name | elementor-mcp-wordpress-builder |
| description | Build and manage WordPress Elementor pages programmatically through MCP server with 118+ AI-ready tools for page design, widgets, layouts, and theme building. |
| triggers | ["create an Elementor page in WordPress","add widgets to my Elementor site","build a WordPress page with Elementor containers","update Elementor page layout programmatically","manage WordPress theme templates with Elementor","apply brand kit to Elementor site","list available Elementor widgets and tools","connect MCP server to WordPress Elementor"] |
Elementor MCP WordPress Builder Skill
Skill by ara.so — MCP Skills collection.
Overview
Elementor MCP Server is a WordPress plugin that exposes Elementor's page building, widget management, and theme builder capabilities through the Model Context Protocol (MCP). It provides 118+ tools for AI agents to create, manipulate, and manage Elementor page designs programmatically without manual editor interaction.
Key capabilities:
- Create and manage pages, posts, and templates
- Add and configure 62+ widgets (free) or 101+ (with Pro)
- Build layouts with flexbox containers
- Manage global design tokens (colors, typography)
- Apply brand kits for instant site restyling
- Create theme templates (headers, footers, singles, archives)
- Build popups with triggers and conditions (Pro)
- Generate custom widgets from AI specs (Pro)
- Search and insert stock images from Openverse
- Inject custom CSS/JS at element, page, or site level
Installation
Prerequisites
| Requirement | Version |
|---|
| WordPress | >= 6.9 |
| PHP | >= 8.0 |
| Elementor | >= 3.20 |
Steps
-
Install Elementor:
wp plugin install elementor --activate
-
Install WordPress MCP Adapter:
The adapter is bundled with the plugin — no separate installation needed.
-
Install Elementor MCP Plugin:
-
Create Application Password:
- Go to Users > Profile > Application Passwords
- Generate new password (save it securely)
-
Configure MCP Connection:
- Navigate to EMCP Tools > Connection in WordPress admin
- Enter username and Application Password
- Copy generated config for your AI client
Configuration
MCP Server Endpoint
https://your-site.com/wp-json/mcp/elementor-mcp-server
Claude Desktop Configuration
Add to claude_desktop_config.json:
{
"mcpServers": {
"elementor-mcp": {
"type": "http",
"url": "https://your-site.com/wp-json/mcp/elementor-mcp-server",
"headers": {
"Authorization": "Basic BASE64_CREDENTIALS_HERE"
}
}
}
}
Generate BASE64_CREDENTIALS_HERE:
echo -n "username:app-password" | base64
Cursor Configuration
.cursor/mcp.json in project root:
{
"mcpServers": {
"elementor-mcp": {
"url": "https://your-site.com/wp-json/mcp/elementor-mcp-server",
"headers": {
"Authorization": "Basic BASE64_CREDENTIALS_HERE"
}
}
}
}
Node.js Proxy (Recommended for Remote Sites)
For remote WordPress sites or protocol compatibility:
{
"mcpServers": {
"elementor-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@msrbuilds/emcp-proxy@latest"],
"env": {
"WP_URL": "https://your-site.com",
"WP_USERNAME": "admin",
"WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
"MCP_PROTOCOL_VERSION": "2024-11-05"
}
}
}
}
Low-Tools Mode
For MCP clients with tool count limits (Antigravity, Gemini API):
- Go to EMCP Tools > Tools in WordPress admin
- Enable Low-tools Mode toggle
- Reduces active tools from 118+ to ~50 essentials
Core MCP Tools
Discovery & Querying
list-widgets — Get all available Elementor widgets:
{
"tool": "list-widgets"
}
get-widget-schema — Inspect widget configuration schema:
{
"tool": "get-widget-schema",
"arguments": {
"widget_type": "heading"
}
}
get-page-structure — Retrieve page element tree:
{
"tool": "get-page-structure",
"arguments": {
"post_id": 123
}
}
get-element-settings — Get specific element configuration:
{
"tool": "get-element-settings",
"arguments": {
"post_id": 123,
"element_id": "abc123"
}
}
Page Management
create-page — Create new Elementor page:
{
"tool": "create-page",
"arguments": {
"title": "Services Landing Page",
"status": "publish",
"content": "Initial content"
}
}
update-page-settings — Modify page-level settings:
{
"tool": "update-page-settings",
"arguments": {
"post_id": 123,
"settings": {
"page_layout": "full_width",
"custom_css": ".my-class { color: blue; }"
}
}
}
clear-page-content — Remove all elements from page:
{
"tool": "clear-page-content",
"arguments": {
"post_id": 123
}
}
Layout Building
add-container — Add flexbox container:
{
"tool": "add-container",
"arguments": {
"post_id": 123,
"settings": {
"content_width": "full",
"flex_direction": "column",
"flex_gap": {
"size": 20,
"unit": "px"
},
"background_background": "classic",
"background_color": "#f5f5f5",
"padding": {
"top": 40,
"right": 20,
"bottom": 40,
update-container — Modify existing container:
{
"tool": "update-container",
"arguments": {
"post_id": 123,
"element_id": "abc123",
"settings": {
"flex_direction": "row",
"flex_justify_content": "space-between"
}
}
}
move-element — Reposition element:
{
"tool": "move-element",
"arguments": {
"post_id": 123,
"element_id": "abc123",
"new_parent_id": "xyz789",
"new_position": 1
}
}
remove-element — Delete element:
{
"tool": "remove-element",
"arguments": {
"post_id": 123,
"element_id": "abc123"
}
}
duplicate-element — Clone element:
{
"tool": "duplicate-element",
"arguments": {
"post_id": 123,
"element_id": "abc123",
"new_parent_id": "parent456",
"new_position": 2
}
}
Widget Management
add-widget — Universal widget insertion:
{
"tool": "add-widget",
"arguments": {
"post_id": 123,
"widget_type": "heading",
"settings": {
"title": "Welcome to Our Services",
"header_size": "h1",
"align": "center",
"title_color": "#333333",
"typography_typography": "custom",
"typography_font_size": {
"size": 48,
"unit": "px"
},
"typography_font_weight": "700"
},
"parent_id"
add-heading — Convenience shortcut for headings:
{
"tool": "add-heading",
"arguments": {
"post_id": 123,
"title": "Our Mission",
"header_size": "h2",
"align": "left",
"parent_id": "container123"
}
}
add-text-editor — Add rich text content:
{
"tool": "add-text-editor",
"arguments": {
"post_id": 123,
"editor": "<p>We deliver cutting-edge solutions for modern businesses.</p>",
"parent_id": "container123"
}
}
add-button — Insert call-to-action button:
{
"tool": "add-button",
"arguments": {
"post_id": 123,
"text": "Get Started",
"link": {
"url": "https://example.com/signup",
"is_external": true,
"nofollow": false
},
"align": "center",
"button_type": "success",
"parent_id": "container123"
}
}
add-image — Insert image widget:
{
"tool": "add-image",
"arguments": {
"post_id": 123,
"image": {
"id": 456,
"url": "https://example.com/wp-content/uploads/hero.jpg"
},
"image_size": "full",
"align": "center",
"parent_id": "container123"
}
}
update-widget — Modify existing widget:
{
"tool": "update-widget",
"arguments": {
"post_id": 123,
"element_id": "widget789",
"settings": {
"title": "Updated Heading Text",
"title_color": "#0066cc"
}
}
}
Pro Widgets (Elementor Pro Required)
add-nav-menu — Add navigation menu:
{
"tool": "add-nav-menu",
"arguments": {
"post_id": 123,
"menu": "primary",
"layout": "horizontal",
"parent_id": "header-container"
}
}
add-loop-grid — Create dynamic content loop:
{
"tool": "add-loop-grid",
"arguments": {
"post_id": 123,
"template_id": 789,
"query_post_type": "post",
"query_posts_per_page": 6,
"columns": 3,
"parent_id": "container123"
}
}
add-popup — Create popup template:
{
"tool": "add-popup",
"arguments": {
"title": "Newsletter Signup",
"triggers": [
{
"type": "exit_intent",
"settings": {}
}
],
"timing": {
"delay": 5
}
}
}
Atomic Elements (Elementor 4.0+)
add-atomic-widget — Add atomic element:
{
"tool": "add-atomic-widget",
"arguments": {
"post_id": 123,
"widget_type": "n-button",
"settings": {
"button_text": "Learn More",
"button_link": {
"url": "/about"
}
},
"parent_id": "container123"
}
}
Available atomic widgets: n-flex, n-div, n-heading, n-paragraph, n-button, n-image, n-svg, n-youtube, n-video, n-divider
Global Settings
get-global-settings — Retrieve site-wide design tokens:
{
"tool": "get-global-settings"
}
update-global-colors — Modify color palette:
{
"tool": "update-global-colors",
"arguments": {
"colors": [
{
"_id": "primary",
"title": "Brand Primary",
"color": "#0066cc"
},
{
"_id": "secondary",
"title": "Brand Secondary",
"color": "#ff6600"
}
]
}
}
update-global-typography — Set typography presets:
{
"tool": "update-global-typography",
"arguments": {
"typography": [
{
"_id": "primary",
"title": "Primary Heading",
"typography_typography": "custom",
"typography_font_family": "Roboto",
"typography_font_size": {
"size": 36,
"unit": "px"
},
"typography_font_weight": "700"
}
]
}
}
Brand Kits
apply-brand-kit — Apply coordinated design system (10 free kits, 50 in Pro):
{
"tool": "apply-brand-kit",
"arguments": {
"kit_name": "modern-tech"
}
}
Available free kits: modern-tech, classic-elegance, bold-creative, minimal-clean, warm-organic, corporate-pro, vibrant-startup, luxury-premium, earthy-natural, playful-fun
backup-brand-kit — Save current design tokens:
{
"tool": "backup-brand-kit",
"arguments": {
"backup_name": "pre-redesign-2024"
}
}
restore-brand-kit — Restore previous backup:
{
"tool": "restore-brand-kit",
"arguments": {
"backup_name": "pre-redesign-2024"
}
}
Templates
save-template — Export page or section as reusable template:
{
"tool": "save-template",
"arguments": {
"post_id": 123,
"template_title": "Hero Section Layout",
"template_type": "section",
"element_id": "section456"
}
}
apply-template — Import template to page:
{
"tool": "apply-template",
"arguments": {
"post_id": 123,
"template_id": 789,
"parent_id": "container123",
"position": 0
}
}
Theme Builder
create-theme-template — Build header/footer/single/archive templates:
{
"tool": "create-theme-template",
"arguments": {
"title": "Site Header",
"template_type": "header",
"display_conditions": {
"include": [
{
"type": "general",
"value": "all"
}
]
}
}
}
Stock Images
search-stock-images — Find Creative Commons images:
{
"tool": "search-stock-images",
"arguments": {
"query": "business team collaboration",
"limit": 10,
"license": "cc0"
}
}
sideload-image — Import image to Media Library:
{
"tool": "sideload-image",
"arguments": {
"image_url": "https://example.com/image.jpg",
"title": "Team Photo",
"alt_text": "Our team collaborating"
}
}
Custom Code
add-element-css — Add CSS to specific element:
{
"tool": "add-element-css",
"arguments": {
"post_id": 123,
"element_id": "widget789",
"css": "selector { border-radius: 10px; box-shadow: 0 4px 6px rgba(0,0,0,0.1); }"
}
}
add-page-css — Inject page-level CSS:
{
"tool": "add-page-css",
"arguments": {
"post_id": 123,
"css": ".custom-section { background: linear-gradient(45deg, #667eea 0%, #764ba2 100%); }"
}
}
add-custom-code-snippet — Create site-wide code injection:
{
"tool": "add-custom-code-snippet",
"arguments": {
"title": "Analytics Script",
"code": "<script>console.log('Page loaded');</script>",
"location": "head",
"priority": 10
}
}
Composite Tools
build-page-from-structure — Create complete page from JSON structure:
{
"tool": "build-page-from-structure",
"arguments": {
"post_id": 123,
"structure": {
"containers": [
{
"settings": {
"content_width": "full",
"background_background": "classic",
"background_color": "#ffffff"
},
"children": [
{
"widget_type": "heading",
"settings": {
"title": "Welcome",
"header_size": "h1"
}
}
Common Patterns
Building a Complete Landing Page
{
"tool": "create-page",
"arguments": {
"title": "Product Launch",
"status": "draft"
}
}
{
"tool": "add-container",
"arguments": {
"post_id": 123,
"settings": {
"content_width": "full",
"min_height": {
"size": 600,
"unit": "px"
},
"flex_direction": "column",
"flex_justify_content"
Applying Dynamic Content (Pro)
{
"tool": "add-loop-grid",
"arguments": {
"post_id": 123,
"template_id": 456,
"query_post_type": "post",
"query_posts_per_page": 9,
"query_orderby": "date",
"query_order": "DESC",
"columns": 3,
"columns_tablet": 2,
"columns_mobile": 1,
"parent_id": "blog-container"
}
}
Theming Entire Site
{
"tool": "create-theme-template",
"arguments": {
"title": "Global Header",
"template_type": "header",
"display_conditions": {
"include": [
{ "type": "general", "value": "all" }
]
}
}
}
{
"tool": "add-container",
"arguments": {
"post_id": 789,
"settings": {
"flex_direction": "row",
Batch Operations
{
"tool": "batch-update-elements",
"arguments": {
"post_id": 123,
"updates": [
{
"element_id": "heading1",
"settings": { "title_color": "#0066cc" }
},
{
"element_id": "heading2",
"settings": { "title_color": "#0066cc" }
},
{
"element_id": "button1",
"settings": { "button_type": "primary" }
Troubleshooting
Connection Issues
Problem: 401 Unauthorized response
Solution: Verify Application Password encoding:
echo -n "admin:xxxx xxxx xxxx xxxx" | base64
curl -H "Authorization: Basic YOUR_BASE64_HERE" \
https://your-site.com/wp-json/mcp/elementor-mcp-server
Problem: 404 Not Found on MCP endpoint
Solution:
wp rewrite flush
wp plugin list --status=active | grep elementor-mcp
Tool Count Issues
Problem: Client rejects connection due to too many tools
Solution: Enable Low-tools Mode in EMCP Tools > Tools or filter tools manually:
{
"tool": "toggle-tools",
"arguments": {
"enabled_tools": [
"create-page",
"add-container",
"add-widget",
"get-page-structure",
"update-widget"
]
}
}
Widget Schema Errors
Problem: Widget won't accept certain settings
Solution: Inspect widget schema first:
{
"tool": "get-widget-schema",
"arguments": {
"widget_type": "heading"
}
}
Check returned JSON Schema for valid property names, types, and constraints.
Container Nesting Issues
Problem: Elements appear in wrong location
Solution: Always verify parent container exists:
{ "tool": "get-page-structure", "arguments": { "post_id": 123 } }
Dynamic Tags Not Working (Pro)
Problem: Dynamic content not rendering
Solution: List available tags first:
{
"tool": "list-dynamic-tags"
}
Then bind using exact tag name:
{
"tool": "update-widget",
"arguments": {
"post_id": 123,
"element_id": "widget789",
"settings": {
"title": "{{dynamic-tag:post-title}}"
}
}
}
Brand Kit Not Applying
Problem: apply-brand-kit returns error
Solution: Check kit availability:
Custom Widget Builder Errors (Pro)
Problem: Widget doesn't appear in editor
Solution: Verify widget spec structure:
{
"widget_id": "unique-id",
"widget_name": "My Widget",
"widget_category": "custom",
"controls": [
{
"id": "text",
"type": "text",
"label": "Content"
}
],
"template": "<div>{{ settings.text }}</div>"
}
All required fields: widget_id, widget_name, widget_category, controls array, template string.
Environment Variables
When using Node.js proxy (npx @msrbuilds/emcp-proxy):
| Variable | Required | Description |
|---|
WP_URL | Yes | WordPress site URL (e.g., https://example.com) |
WP_USERNAME | Yes | WordPress username |
WP_APP_PASSWORD | Yes | Application Password (spaces allowed) |
MCP_PROTOCOL_VERSION | No | Override protocol version (default: 2025-06-18) |
MCP_LOG_FILE | No | Path for debug logging (e.g., /tmp/emcp.log) |
Resources
License
GPL-2.0-or-later — Same as WordPress and Elementor
