WP Manifestindependent plugin directory
manifest / builders / elementor-mcp-api

NeoService Elementor API

WordPress plugin — REST API + MCP protocol for AI-driven Elementor page editing

by NeoService · github.com/bvisible/elementor-mcp-api

★ 10stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/bvisible/elementor-mcp-api/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/bvisible/elementor-mcp-api ↗

WordPress plugin that exposes a REST API + MCP (Model Context Protocol) abilities for AI-driven Elementor page editing.

Build, edit, and manage Elementor pages programmatically — designed to be used by AI agents (Claude, GPT, etc.) or any HTTP client.

Features

  • Full CRUD on Elementor pages, elements, and templates
  • Granular element editing — update a single widget's settings without touching the rest
  • Element operations — add, remove, duplicate, move elements in the page tree
  • Global kit management — read/write colors, fonts, and site-wide settings
  • Widget discovery — list all available widgets and get their control schemas
  • MCP protocol support — auto-registers 20 abilities when used with WordPress Abilities API + WordPress MCP Adapter
  • CSS cache management — flush Elementor CSS after changes

Requirements

  • WordPress 6.0+
  • PHP 7.4+
  • Elementor (free or Pro)
  • Authentication: WordPress Application Passwords (recommended) or cookie auth

Installation

  1. Download or clone this repository into wp-content/plugins/:
    cd wp-content/plugins/
git clone https://github.com/bvisible/elementor-mcp-api.git
  2. Activate the plugin in WordPress admin
  3. Create an Application Password in Users → Your Profile → Application Passwords

API Endpoints

Base URL: https://your-site.com/wp-json/neoservice/v1

Pages

Method Endpoint Description
GET /pages List all Elementor pages
GET /page/{id} Full page data (elements tree)
GET /page/{id}/structure Lightweight structure (IDs, types, hints)
PUT /page/{id} Replace all page data
POST /page Create a new page
POST /build-page Create or update a full page

Elements

Method Endpoint Description
GET /page/{id}/element/{eid} Get single element data
PATCH /page/{id}/element/{eid} Update element settings (merge)
POST /page/{id}/element Add new element
DELETE /page/{id}/element/{eid} Remove element
POST /page/{id}/element/{eid}/duplicate Duplicate element
POST /page/{id}/element/{eid}/move Move element to new position

Templates

Method Endpoint Description
GET /templates List all templates
POST /template Create template (header, footer, etc.)

Global Settings

Method Endpoint Description
GET /kit Get global kit settings
PUT /kit Update global kit settings

Widgets

Method Endpoint Description
GET /widgets List all registered widgets
GET /widget/{name}/schema Get widget control schema
GET /widget/{name}/defaults Ready-to-use element JSON with defaults

Cache

Method Endpoint Description
POST /flush-css Flush Elementor CSS cache

Quick Start

API="https://your-site.com/wp-json/neoservice/v1"
AUTH="username:your-application-password"

# List pages
curl -s -u "$AUTH" "$API/pages"

# Get page structure (always start here)
curl -s -u "$AUTH" "$API/page/8/structure"

# Update an element's title color
curl -s -X PATCH -u "$AUTH" -H "Content-Type: application/json" \
  -d '{"settings":{"title_color":"#333333"}}' \
  "$API/page/8/element/f8703b57"

# Flush CSS after changes
curl -s -X POST -u "$AUTH" "$API/flush-css"

MCP Integration

This plugin can expose its capabilities via the Model Context Protocol for direct AI agent integration:

  1. Install WordPress Abilities API
  2. Install WordPress MCP Adapter
  3. The plugin auto-registers 20 abilities — no configuration needed

MCP endpoint: https://your-site.com/wp-json/mcp/mcp-adapter-default-server

Claude Code Skill

This repo includes a ready-to-use Claude Code skill in claude-skill/. It teaches Claude how to use the API: workflows, element structures, widget settings, layout patterns, and design best practices.

Install the skill

cd elementor-mcp-api/
bash claude-skill/install.sh

This copies the skill to ~/.claude/skills/elementor-builder/. Restart Claude Code — then just say "build an Elementor page" and it knows how.

What the skill provides

  • Full API workflow (discover → explore → edit → flush → verify)
  • Elementor element JSON structure and common widget settings
  • Reusable section patterns (hero, content rows, icon grids, contact forms, photo collages)
  • Design best practices (zigzag layouts, background color alternation, responsive rules)
  • Critical gotchas (race conditions, CSS cache, flex layout math)

Important Notes

  • Sequential PATCH calls: Never run multiple PATCH calls in parallel on the same page. Each PATCH loads, modifies, and saves the full page — parallel calls overwrite each other. Cross-page parallelism is safe.
  • Flush CSS: Always call /flush-css after visual changes — Elementor caches CSS aggressively.
  • Element IDs: Always provide valid 8-character hex IDs when creating elements.
  • PATCH merges settings: Only send the settings you want to change, not the full settings object.

License

GPL-3.0 — see LICENSE