MCP Tools for Elementor

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

• 70 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 — 41 widget tools: universal add/update for any widget, plus 23 free convenience shortcuts (heading, text, image, button, video, icon, spacer, divider, icon box, accordion, alert, counter, Google Maps, icon list, image box, image carousel, progress bar, social icons, star rating, tabs, testimonial, toggle, HTML)
• Pro Widget Support — 16 conditional Pro widget tools (form, posts grid, countdown, price table, flip box, animated headline, call to action, slides, testimonial carousel, price list, gallery, share buttons, table of contents, blockquote, Lottie, hotspot)
• 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

Get 50+ Premium Prompts to Build High Quality Landing Pages

I Want This

Requirements

Installation

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.

Connecting to the MCP Server

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

Prerequisites

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.

Claude Code

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"
            }
        }
    }
}

Claude Desktop

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"
            }
        }
    }
}

Cursor

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"
            }
        }
    }
}

Windsurf

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"
            }
        }
    }
}

Antigravity

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"
            }
        }
    }
}

npx mcp-remote (Local Development)

For local development, you can use mcp-remote to bridge your AI client to the WordPress HTTP endpoint via stdio. This works with any MCP client that supports stdio transport:

{
    "mcpServers": {
        "elementor-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "http://localhost:10003/wp-json/mcp/elementor-mcp-server",
                "--header",
                "Authorization: Basic BASE64_ENCODED_CREDENTIALS"
            ]
        }
    }
}

Replace localhost:10003 with your local WordPress address and BASE64_ENCODED_CREDENTIALS with your Base64-encoded username:app-password.

WP-CLI stdio (Local Development)

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"
            ]
        }
    }
}

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)

Page Management (5 tools)

Layout (4 tools)

Widgets (41 tools)

Templates (2 tools)

Global Settings (2 tools)

Composite (1 tool)

Stock Images (3 tools)

SVG Icons (1 tool)

Custom Code (4 tools)

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

Troubleshooting

• "No MCP servers registered" — Ensure the MCP Tools for Elementor 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.

Sample Prompts

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.

Contributing

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

License

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