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

1. Install and activate Elementor (version 3.20+).
2. Install and activate the WordPress MCP Adapter plugin.
3. Upload the elementor-mcp folder to /wp-content/plugins/.
4. Activate the plugin through the Plugins menu in WordPress.
5. 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.

1. Create a WordPress Application Password at Users > Profile > Application Passwords.
2. 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.