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.

• 97 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, update containers, find elements, batch update, reorder children, get container schema
• Widget Tools — 51 widget tools: universal add/update for any widget, plus 27 free convenience shortcuts and 22 conditional Pro widget tools
• Pro Widget Support — 22 conditional Pro widget tools including nav menu, loop grid, loop carousel, media carousel, nested tabs, nested accordion, and more
• Theme Builder — Create theme templates (header/footer/single/archive), set display conditions (Pro)
• Dynamic Tags — List all available dynamic tags, bind dynamic data to element settings (Pro)
• Popup Builder — Create popup templates, configure triggers/conditions/timing (Pro)
• 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
• SVG Icons — Upload SVG icons from URL or raw markup for use with Elementor icon widgets
• Custom Code — Add custom CSS (element/page level), inject JavaScript, create site-wide code snippets for head/body injection
• Admin Dashboard — Toggle individual tools on/off and view connection configs for all supported MCP clients

1. Install and activate Elementor (version 3.20+).
2. Install and activate the WordPress MCP Adapter plugin.
3. Download the latest release zip from the Releases page.
4. In WordPress, go to Plugins > Add New > Upload Plugin and upload the downloaded zip file.
5. Activate the plugin through the Plugins menu in WordPress.
6. Go to Settings > MCP Tools for Elementor to configure tools and view connection info.

Connect to your WordPress site from any AI client using HTTP. No proxy or Node.js needed — just a WordPress Application Password.

1. Create an Application Password at Users > Profile > Application Passwords.
2. Base64-encode your credentials: echo -n "username:app-password" | base64
3. Your MCP endpoint is: https://your-site.com/wp-json/mcp/elementor-mcp-server

Tip: The plugin's admin page at Settings > MCP Tools for Elementor > Connection can generate all configs automatically — just enter your username and Application Password.

Add as .mcp.json in your project root:

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

Add to claude_desktop_config.json (%APPDATA%\Claude\ on Windows, ~/Library/Application Support/Claude/ on macOS):

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

Add to .cursor/mcp.json in your project root, or ~/.cursor/mcp.json for global config:

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

Add to ~/.codeium/windsurf/mcp_config.json:

{
    "mcpServers": {
        "elementor-mcp": {
            "serverUrl": "https://your-site.com/wp-json/mcp/elementor-mcp-server",
            "headers": {
                "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
            }
        }
    }
}

Add to ~/.gemini/antigravity/mcp_config.json:

{
    "mcpServers": {
        "elementor-mcp": {
            "serverUrl": "https://your-site.com/wp-json/mcp/elementor-mcp-server",
            "headers": {
                "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
            }
        }
    }
}

For local development with WP-CLI available, you can use the stdio transport (no HTTP auth needed):

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

For remote WordPress sites, environments without WP-CLI, or when your AI client needs a different MCP protocol version, use the bundled Node.js proxy:

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

Optional environment variables:

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

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.

If the MCP server connects but no tools appear in Claude Code, Cursor, or other clients:

1. Verify tools are registered. Test the endpoint directly with curl to confirm the server returns tools:

   curl -s -u admin:YOUR_APP_PASSWORD \
     https://your-site.com/wp-json/mcp/elementor-mcp-server \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

   If this returns a valid JSON-RPC response with serverInfo, the server is working. The issue is likely a protocol version mismatch between the server and your client.

2. Check for protocol version mismatch. The WordPress MCP Adapter reports protocol version 2025-06-18. Some clients only support 2024-11-05. If using the Node.js proxy, set the MCP_PROTOCOL_VERSION environment variable to override:

   "env": {
       "MCP_PROTOCOL_VERSION": "2024-11-05"
   }

3. Enable debug logging. Add the MCP_LOG_FILE environment variable to your proxy config to capture the full request/response flow:

   "env": {
       "MCP_LOG_FILE": "/tmp/elementor-mcp-debug.log"
   }

   The log will show the protocol version, session IDs, tools count, and response bodies.

4. Use the proxy instead of direct HTTP. If you're using type: "http" to connect directly, your client must handle Mcp-Session-Id headers. Clients that don't support session management should use the Node.js proxy instead, which handles sessions automatically.

• "No MCP servers registered" — Ensure the MCP Tools for Elementor plugin is active and all dependencies (Elementor, MCP Adapter, Abilities API) are met.
• HTTP 401 — Check your Application Password is correct and the user has edit_posts capability.
• "Missing Mcp-Session-Id header" — The HTTP endpoint requires an Mcp-Session-Id header on all requests after initialize. Use the Node.js proxy (which handles this automatically) instead of direct HTTP connections.
• Session errors — If connecting via direct HTTP, your client must capture the Mcp-Session-Id response header from initialize and include it on all subsequent requests.
• WP-CLI not found on Windows — Use the full path to php.exe and wp-cli.phar.

The prompts/ directory includes ready-to-use landing page prompts that demonstrate the full power of MCP Tools for Elementor tools. Each prompt is a complete blueprint — paste it into your AI client and watch an entire page get built automatically.

Each prompt includes:

• Complete design system (color palette, typography, spacing)
• Image search keywords for stock photo sourcing
• SVG icon specifications
• Full page structure (hero, sections, footer)
• Entrance animations using Elementor's built-in Motion Effects
• Custom CSS for hover states
• Custom JavaScript for scroll animations and counters
• Step-by-step execution order

Want more? A premium collection of 50 industry-specific prompts covering restaurants, med spas, law firms, florists, photography studios, and more is available separately.

We welcome contributions from the community! Whether it's bug reports, feature requests, documentation improvements, or code contributions — every bit helps.

See CONTRIBUTING.md for detailed guidelines on how to get started.

Quick start:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-tool)
3. Make your changes and test locally
4. Submit a Pull Request

• @msrbuilds — Original author and maintainer
• @mhamzashafiq — Layout & element tools, widget convenience shortcuts, theme builder, dynamic tags, popup builder, WooCommerce widget tools, motion effects support, settings validator improvements

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