Run any Skill in Manus with one click

elementor-mcp-wordpress-builder

Stars2

Forks0

UpdatedJune 22, 2026 at 00:52

Build and manage WordPress Elementor pages programmatically through MCP server with 118+ AI-ready tools for page design, widgets, layouts, and theme building.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

Aradotso

Aradotso/mcp-skills

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

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:

# Via WP-CLI
wp plugin install elementor --activate

Install WordPress MCP Adapter: The adapter is bundled with the plugin — no separate installation needed.
Install Elementor MCP Plugin:
- Download latest release from GitHub Releases
- Upload via WordPress Admin > Plugins > Add New > Upload Plugin
- Or via WP-CLI:
```
wp plugin install /path/to/elementor-mcp.zip --activate
```
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,
        "left": 20,
        "unit": "px"
      }
    },
    "parent_id": null,
    "position": 0
  }
}

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": "container123",
    "position": 0
  }
}

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"
              }
            },
            {
              "widget_type": "text-editor",
              "settings": {
                "editor": "<p>Your content here.</p>"
              }
            }
          ]
        }
      ]
    }
  }
}

Common Patterns

Building a Complete Landing Page

// Step 1: Create page
{
  "tool": "create-page",
  "arguments": {
    "title": "Product Launch",
    "status": "draft"
  }
}
// Returns: { "post_id": 123 }

// Step 2: Add hero container
{
  "tool": "add-container",
  "arguments": {
    "post_id": 123,
    "settings": {
      "content_width": "full",
      "min_height": {
        "size": 600,
        "unit": "px"
      },
      "flex_direction": "column",
      "flex_justify_content": "center",
      "flex_align_items": "center",
      "background_background": "gradient",
      "background_color": "#667eea",
      "background_color_b": "#764ba2"
    }
  }
}
// Returns: { "element_id": "hero-container" }

// Step 3: Add hero heading
{
  "tool": "add-heading",
  "arguments": {
    "post_id": 123,
    "title": "Revolutionary Product Launch",
    "header_size": "h1",
    "align": "center",
    "title_color": "#ffffff",
    "parent_id": "hero-container"
  }
}

// Step 4: Add CTA button
{
  "tool": "add-button",
  "arguments": {
    "post_id": 123,
    "text": "Pre-Order Now",
    "link": {
      "url": "/preorder"
    },
    "button_type": "success",
    "size": "lg",
    "parent_id": "hero-container"
  }
}

// Step 5: Add features section
{
  "tool": "add-container",
  "arguments": {
    "post_id": 123,
    "settings": {
      "flex_direction": "row",
      "flex_gap": {
        "size": 30,
        "unit": "px"
      }
    }
  }
}

Applying Dynamic Content (Pro)

// Create loop grid for blog posts
{
  "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

// Step 1: Create header template
{
  "tool": "create-theme-template",
  "arguments": {
    "title": "Global Header",
    "template_type": "header",
    "display_conditions": {
      "include": [
        { "type": "general", "value": "all" }
      ]
    }
  }
}

// Step 2: Build header structure
{
  "tool": "add-container",
  "arguments": {
    "post_id": 789,
    "settings": {
      "flex_direction": "row",
      "flex_justify_content": "space-between"
    }
  }
}

// Step 3: Add logo
{
  "tool": "add-image",
  "arguments": {
    "post_id": 789,
    "image": { "id": 101 },
    "parent_id": "header-container"
  }
}

// Step 4: Add navigation (Pro)
{
  "tool": "add-nav-menu",
  "arguments": {
    "post_id": 789,
    "menu": "primary",
    "layout": "horizontal",
    "parent_id": "header-container"
  }
}

Batch Operations

// Update multiple elements at once
{
  "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:

# Correct format (no spaces in username:password)
echo -n "admin:xxxx xxxx xxxx xxxx" | base64

# Test connection
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:

# Flush rewrite rules
wp rewrite flush

# Verify plugin is active
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:

// Get page structure first
{ "tool": "get-page-structure", "arguments": { "post_id": 123 } }

// Find correct parent_id in returned tree
// Then add element with verified parent_id

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:

// Free version has 10 kits
// Pro version has 50 kits

// List available kits via WordPress admin:
// EMCP Tools > Brand Kits tab

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

Documentation: https://emcp.msrbuilds.com
GitHub Repository: https://github.com/msrbuilds/elementor-mcp
Issue Tracker: https://github.com/msrbuilds/elementor-mcp/issues
Support Portal: Available in EMCP Tools > Get Support tab
MCP Protocol Spec: https://modelcontextprotocol.io
WordPress MCP Adapter: https://github.com/WordPress/mcp-adapter
Elementor Developer Docs: https://developers.elementor.com

License

GPL-2.0-or-later — Same as WordPress and Elementor

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

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:

# Via WP-CLI
wp plugin install elementor --activate

Install WordPress MCP Adapter: The adapter is bundled with the plugin — no separate installation needed.
Install Elementor MCP Plugin:
- Download latest release from GitHub Releases
- Upload via WordPress Admin > Plugins > Add New > Upload Plugin
- Or via WP-CLI:
```
wp plugin install /path/to/elementor-mcp.zip --activate
```
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,
        "left": 20,
        "unit": "px"
      }
    },
    "parent_id": null,
    "position": 0
  }
}

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": "container123",
    "position": 0
  }
}

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"
              }
            },
            {
              "widget_type": "text-editor",
              "settings": {
                "editor": "<p>Your content here.</p>"
              }
            }
          ]
        }
      ]
    }
  }
}

Common Patterns

Building a Complete Landing Page

// Step 1: Create page
{
  "tool": "create-page",
  "arguments": {
    "title": "Product Launch",
    "status": "draft"
  }
}
// Returns: { "post_id": 123 }

// Step 2: Add hero container
{
  "tool": "add-container",
  "arguments": {
    "post_id": 123,
    "settings": {
      "content_width": "full",
      "min_height": {
        "size": 600,
        "unit": "px"
      },
      "flex_direction": "column",
      "flex_justify_content": "center",
      "flex_align_items": "center",
      "background_background": "gradient",
      "background_color": "#667eea",
      "background_color_b": "#764ba2"
    }
  }
}
// Returns: { "element_id": "hero-container" }

// Step 3: Add hero heading
{
  "tool": "add-heading",
  "arguments": {
    "post_id": 123,
    "title": "Revolutionary Product Launch",
    "header_size": "h1",
    "align": "center",
    "title_color": "#ffffff",
    "parent_id": "hero-container"
  }
}

// Step 4: Add CTA button
{
  "tool": "add-button",
  "arguments": {
    "post_id": 123,
    "text": "Pre-Order Now",
    "link": {
      "url": "/preorder"
    },
    "button_type": "success",
    "size": "lg",
    "parent_id": "hero-container"
  }
}

// Step 5: Add features section
{
  "tool": "add-container",
  "arguments": {
    "post_id": 123,
    "settings": {
      "flex_direction": "row",
      "flex_gap": {
        "size": 30,
        "unit": "px"
      }
    }
  }
}

Applying Dynamic Content (Pro)

// Create loop grid for blog posts
{
  "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

// Step 1: Create header template
{
  "tool": "create-theme-template",
  "arguments": {
    "title": "Global Header",
    "template_type": "header",
    "display_conditions": {
      "include": [
        { "type": "general", "value": "all" }
      ]
    }
  }
}

// Step 2: Build header structure
{
  "tool": "add-container",
  "arguments": {
    "post_id": 789,
    "settings": {
      "flex_direction": "row",
      "flex_justify_content": "space-between"
    }
  }
}

// Step 3: Add logo
{
  "tool": "add-image",
  "arguments": {
    "post_id": 789,
    "image": { "id": 101 },
    "parent_id": "header-container"
  }
}

// Step 4: Add navigation (Pro)
{
  "tool": "add-nav-menu",
  "arguments": {
    "post_id": 789,
    "menu": "primary",
    "layout": "horizontal",
    "parent_id": "header-container"
  }
}

Batch Operations

// Update multiple elements at once
{
  "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:

# Correct format (no spaces in username:password)
echo -n "admin:xxxx xxxx xxxx xxxx" | base64

# Test connection
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:

# Flush rewrite rules
wp rewrite flush

# Verify plugin is active
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:

// Get page structure first
{ "tool": "get-page-structure", "arguments": { "post_id": 123 } }

// Find correct parent_id in returned tree
// Then add element with verified parent_id

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:

// Free version has 10 kits
// Pro version has 50 kits

// List available kits via WordPress admin:
// EMCP Tools > Brand Kits tab

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

Documentation: https://emcp.msrbuilds.com
GitHub Repository: https://github.com/msrbuilds/elementor-mcp
Issue Tracker: https://github.com/msrbuilds/elementor-mcp/issues
Support Portal: Available in EMCP Tools > Get Support tab
MCP Protocol Spec: https://modelcontextprotocol.io
WordPress MCP Adapter: https://github.com/WordPress/mcp-adapter
Elementor Developer Docs: https://developers.elementor.com

License

GPL-2.0-or-later — Same as WordPress and Elementor

elementor-mcp-wordpress-builder

More from this repository

More from this repository

Elementor MCP WordPress Builder Skill

Overview

Installation

Prerequisites

Steps

Configuration

MCP Server Endpoint

Claude Desktop Configuration

Cursor Configuration

Node.js Proxy (Recommended for Remote Sites)

Low-Tools Mode

Core MCP Tools

Discovery & Querying

Page Management

Layout Building

Widget Management

Pro Widgets (Elementor Pro Required)

Atomic Elements (Elementor 4.0+)

Global Settings

Brand Kits

Templates

Theme Builder

Stock Images

Custom Code

Composite Tools

Common Patterns

Building a Complete Landing Page

Applying Dynamic Content (Pro)

Theming Entire Site

Batch Operations

Troubleshooting

Connection Issues

Tool Count Issues

Widget Schema Errors

Container Nesting Issues

Dynamic Tags Not Working (Pro)

Brand Kit Not Applying

Custom Widget Builder Errors (Pro)

Environment Variables

Resources

License

Elementor MCP WordPress Builder Skill

Overview

Installation

Prerequisites

Steps

Configuration

MCP Server Endpoint

Claude Desktop Configuration

Cursor Configuration

Node.js Proxy (Recommended for Remote Sites)

Low-Tools Mode

Core MCP Tools

Discovery & Querying

Page Management

Layout Building

Widget Management

Pro Widgets (Elementor Pro Required)

Atomic Elements (Elementor 4.0+)

Global Settings

Brand Kits

Templates

Theme Builder

Stock Images

Custom Code

Composite Tools

Common Patterns

Building a Complete Landing Page

Applying Dynamic Content (Pro)

Theming Entire Site

Batch Operations

Troubleshooting

Connection Issues

Tool Count Issues

Widget Schema Errors

Container Nesting Issues

Dynamic Tags Not Working (Pro)