elementor-mcp  by msrbuilds

AI-driven WordPress page design and management

Created 2 months ago
346 stars

Top 80.1% on SourcePulse

GitHubView on GitHub
Project Summary

This WordPress plugin exposes Elementor's page-building capabilities as a Model Context Protocol (MCP) server, enabling AI agents like Claude and Cursor to programmatically create, edit, and manage website designs. It offers a comprehensive suite of 97 tools, benefiting developers and designers seeking AI-driven automation for Elementor workflows.

How It Works

The plugin integrates with the WordPress MCP Adapter, translating Elementor's data, widgets, and design tools into MCP commands. AI clients connect via HTTP using WordPress Application Passwords or through a local WP-CLI or Node.js proxy. This allows for programmatic control over page structure, widget manipulation, template management, and global design settings.

Quick Start & Requirements

  • Primary Install: Install and activate Elementor (v3.20+), WordPress MCP Adapter (latest), and then upload and activate this plugin.
  • Prerequisites: WordPress >= 6.8, PHP >= 7.4, Elementor >= 3.20 (container support required), WordPress MCP Adapter, WordPress Abilities API (bundled in WP 6.9+ or via Composer).
  • Connection: Requires a WordPress Application Password for HTTP connections. Configuration is available via the plugin's admin settings page.
  • Links: No external quick-start or documentation links provided beyond the repository's README.

Highlighted Details

  • Offers 97 MCP Tools covering Elementor's full workflow, including query/discovery, page management, layout tools, and extensive widget manipulation.
  • Supports 51 widget tools, including universal add/update functions and 22 conditional Pro widget tools (e.g., Nav Menu, Loop Grid, Media Carousel).
  • Enables programmatic control over Theme Builder (Pro), Popup Builder (Pro), Dynamic Tags (Pro), Global Settings, custom code injection, and stock image/SVG integration.
  • Includes sample prompts for various industries and a premium prompt pack demonstrating full-page generation from declarative JSON structures.

Maintenance & Community

The project is primarily maintained by @msrbuilds, with contributions noted from @mhamzashafiq. Community contributions are welcomed via standard open-source channels. No specific community links (e.g., Discord, Slack) are provided.

Licensing & Compatibility

  • License: GNU General Public License v3.0 (GPL v3.0).
  • Compatibility: As a GPL v3.0 licensed project, derivative works must also be open-sourced under the same license, potentially impacting integration into closed-source commercial products.

Limitations & Caveats

Direct HTTP connections require AI clients to manage Mcp-Session-Id headers; the Node.js proxy is recommended for broader compatibility. Potential protocol version mismatches may occur between clients and the server (e.g., 2025-06-18 vs. 2024-11-05). Certain advanced features are conditional on Elementor Pro.

Health Check
Last Commit

5 days ago

Responsiveness

Inactive

Pull Requests (30d)
5
Issues (30d)
10
Star History
122 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.