Elementor MCP

A WordPress plugin that extends the WordPress MCP Adapter to expose Elementor data, widgets, and page design tools as MCP (Model Context Protocol) tools. This enables AI agents like Claude, Cursor, and other MCP-compatible clients to create and manipulate Elementor page designs programmatically.

Features

~37 MCP Tools covering the full Elementor page-building workflow
Query & Discovery — List widgets, inspect page structures, read element settings, browse templates, view global design tokens
Page Management — Create pages, update settings, clear content, import/export templates
Layout Tools — Add flexbox containers, move/remove/duplicate elements
Widget Tools — Add any widget type with full settings, plus convenience shortcuts for common widgets (heading, text, image, button, video, icon, spacer, divider, icon box)
Pro Widget Support — Conditional tools for Elementor Pro widgets (form, posts grid, countdown, price table, flip box, animated headline) that only register when Pro is active
Template Tools — Save pages or elements as reusable templates, apply templates to pages
Global Settings — Update site-wide color palettes and typography presets
Composite Tools — Build a complete page from a declarative JSON structure in a single call
Stock Images — Search Openverse for Creative Commons images, sideload into Media Library, add to pages
Admin Dashboard — Toggle individual tools on/off and view connection configs for all supported MCP clients

Requirements

| Dependency | Version | |---|---| | WordPress | >= 6.8 | | PHP | >= 7.4 | | Elementor | >= 3.20 (container support required) | | WordPress MCP Adapter | Latest | | WordPress Abilities API | Bundled in WP 6.9+, or via Composer |

Installation

Install and activate Elementor (version 3.20+).
Install and activate the WordPress MCP Adapter plugin.
Upload the elementor-mcp folder to /wp-content/plugins/.
Activate the plugin through the Plugins menu in WordPress.
Go to Settings > Elementor MCP to configure tools and view connection info.

Connecting to the MCP Server

Option A: WP-CLI stdio (recommended for local development)

The MCP Adapter includes a built-in WP-CLI stdio bridge. No HTTP round-trip, no sessions, no auth config needed.

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "elementor-mcp": {
      "command": "wp",
      "args": [
        "mcp-adapter", "serve",
        "--server=elementor-mcp-server",
        "--user=admin",
        "--path=/path/to/wordpress"
      ]
    }
  }
}

Claude Code — add as .mcp.json in your project root:

{
  "mcpServers": {
    "elementor-mcp": {
      "type": "stdio",
      "command": "wp",
      "args": [
        "mcp-adapter", "serve",
        "--server=elementor-mcp-server",
        "--user=admin",
        "--path=/path/to/wordpress"
      ]
    }
  }
}

Verify: wp mcp-adapter list --path=/path/to/wordpress should show elementor-mcp-server.

Option B: Node.js HTTP proxy (remote sites)

For remote WordPress sites or environments without WP-CLI. Uses the bundled proxy at bin/mcp-proxy.mjs.

Create a WordPress Application Password at Users > Profile > Application Passwords.
Configure your MCP client:

{
  "mcpServers": {
    "elementor-mcp": {
      "command": "node",
      "args": ["bin/mcp-proxy.mjs"],
      "env": {
        "WP_URL": "https://your-site.com",
        "WP_USERNAME": "admin",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Option C: Direct HTTP (VS Code MCP extension)

{
  "servers": {
    "elementor-mcp": {
      "type": "http",
      "url": "https://your-site.com/wp-json/mcp/elementor-mcp-server",
      "headers": {
        "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

See mcp-config-examples.json for copy-paste configs for all supported clients.

Testing with MCP Inspector

npx @modelcontextprotocol/inspector wp mcp-adapter serve \
  --server=elementor-mcp-server --user=admin --path=/path/to/wordpress

Available Tools

Query & Discovery (7 tools)

| Tool | Description | |---|---| | list-widgets | All registered widget types with names, titles, icons, categories, keywords | | get-widget-schema | Full JSON Schema for a widget's settings (auto-generated from Elementor controls) | | get-page-structure | Element tree for a page (containers, widgets, nesting) | | get-element-settings | Current settings for a specific element on a page | | list-pages | All Elementor-enabled pages/posts | | list-templates | Saved Elementor templates from the template library | | get-global-settings | Active kit/global settings (colors, typography, spacing) |

Page Management (5 tools)

| Tool | Description | |---|---| | create-page | Create a new WP page/post with Elementor enabled | | update-page-settings | Update page-level Elementor settings (background, padding, etc.) | | delete-page-content | Clear all Elementor content from a page | | import-template | Import JSON template structure into a page | | export-page | Export page's full Elementor data as JSON |

Layout (4 tools)

| Tool | Description | |---|---| | add-container | Add a flexbox container (top-level or nested) | | move-element | Move an element to a new parent/position | | remove-element | Remove an element and all children | | duplicate-element | Duplicate element with fresh IDs |

Widgets (17 tools)

| Tool | Description | |---|---| | add-widget | Universal: add any widget type to a container | | update-widget | Universal: update settings on an existing widget | | add-heading | Convenience: heading widget | | add-text-editor | Convenience: rich text editor widget | | add-image | Convenience: image widget | | add-button | Convenience: button widget | | add-video | Convenience: video widget | | add-icon | Convenience: icon widget | | add-spacer | Convenience: spacer widget | | add-divider | Convenience: divider widget | | add-icon-box | Convenience: icon box widget | | add-form | Pro: form widget | | add-posts-grid | Pro: posts grid widget | | add-countdown | Pro: countdown timer widget | | add-price-table | Pro: price table widget | | add-flip-box | Pro: flip box widget | | add-animated-headline | Pro: animated headline widget |

Templates (2 tools)

| Tool | Description | |---|---| | save-as-template | Save a page or element as reusable template | | apply-template | Apply a saved template to a page |

Global Settings (2 tools)

| Tool | Description | |---|---| | update-global-colors | Update site-wide color palette in Elementor kit | | update-global-typography | Update site-wide typography in Elementor kit |

Composite (1 tool)

| Tool | Description | |---|---| | build-page | Create complete page from declarative structure in one call |

Stock Images (3 tools)

| Tool | Description | |---|---| | search-images | Search Openverse for Creative Commons images by keyword | | sideload-image | Download an external image URL into the WordPress Media Library | | add-stock-image | Search + sideload + add image widget to page in one call |

All tool names are prefixed with elementor-mcp/ in the MCP namespace (e.g., elementor-mcp/list-widgets). The MCP Adapter converts these to elementor-mcp-list-widgets for transport.

Permission Model

| Tool Group | Required WordPress Capability | |---|---| | Read/Query | edit_posts | | Page creation | publish_pages or edit_pages | | Widget/layout manipulation | edit_posts + ownership check | | Template management | edit_posts | | Global settings | manage_options | | Delete operations | delete_posts + ownership check | | Stock image search | edit_posts | | Stock image sideload | upload_files |

Troubleshooting

"No MCP servers registered" — Ensure the Elementor MCP plugin is active and all dependencies are met.
HTTP 401 — Check your Application Password is correct and the user has edit_posts capability.
Session errors — The HTTP endpoint requires Mcp-Session-Id header after initialize; the proxy handles this automatically.
WP-CLI not found on Windows — Use the full path to php.exe and wp-cli.phar.

License

This project is licensed under the GNU General Public License v3.0.

MCP Servers