Ultimate Elementor MCP

# 📖 Ultimate Elementor MCP - User Guide Complete guide to using the Ultimate Elementor MCP for WordPress and Elementor management. --- ## 📋 **Table of Contents** - [Introduction](#introduction) - [Basic Concepts](#basic-concepts) - [WordPress Operations](#wordpress-operations) - [Elementor Operations](#elementor-operations) - [File Operations](#file-operations) - [Advanced Workflows](#advanced-workflows) - [Best Practices](#best-practices) - [Tips and Tricks](#tips-and-tricks) --- ## 🎯 **Introduction** The Ultimate Elementor MCP allows AI assistants to manage WordPress sites and build Elementor pages through natural language commands. Simply describe what you want, and the AI will use the appropriate MCP tools to accomplish it. ### **What Can You Do?** - ✅ Create and manage WordPress posts and pages - ✅ Build complex Elementor layouts with sections, columns, and widgets - ✅ Export and import Elementor data - ✅ Backup and restore page structures - ✅ Manage media, users, and taxonomies - ✅ Manipulate existing Elementor elements - ✅ Work with templates and global settings --- ## 💡 **Basic Concepts** ### **How It Works** 1. **You make a request** in natural language 2. **AI interprets** your request and chooses appropriate tools 3. **MCP executes** the WordPress/Elementor operations 4. **Results are returned** to you ### **Example Workflow** **You say:** > "Create a new page called 'About Us' with a heading and some text" **AI does:** 1. Uses `create_page` to create the WordPress page 2. Uses `create_section`, `create_column` to build structure 3. Uses `create_heading` and `create_text` for content 4. Uses `update_elementor_data` to save the layout **You get:** > "Page created successfully! View it at: https://your-site.com/about-us/" --- ## 📝 **WordPress Operations** ### **Working with Posts** #### **Create a Post** ``` Create a blog post titled "10 WordPress Tips" with introduction text ``` The AI will: - Create the post with `create_post` - Set status (draft/publish based on context) - Add your content #### **Update a Post** ``` Update post ID 123 to change the title to "15 WordPress Tips" ``` #### **List Posts** ``` Show me the 10 most recent published posts ``` ``` Find all draft posts from author ID 2 ``` #### **Search Posts** ``` Search for posts containing the word "tutorial" ``` ### **Working with Pages** #### **Create a Page** ``` Create a new page called "Services" with status set to draft ``` #### **Update a Page** ``` Update the "Contact" page to change its title to "Get in Touch" ``` #### **Find Pages** ``` List all published pages ``` ``` Get the page with slug "about-us" ``` #### **List All Content** ``` Show me all pages and posts with their Elementor status ``` This shows which content has Elementor data and which doesn't. ### **Media Management** #### **Upload Media** ``` Upload the image at /path/to/image.jpg with title "Hero Banner" ``` #### **List Media** ``` Show me the 20 most recent media files ``` ``` List all images in the media library ``` ### **User Management** #### **List Users** ``` Show me all administrator users ``` ``` List the first 50 users ``` #### **Get User Info** ``` Get details for user ID 1 ``` ### **Taxonomy Management** #### **Categories** ``` List all post categories ``` ``` Get details for category ID 5 ``` #### **Tags** ``` Show me all tags ``` --- ## 🎨 **Elementor Operations** ### **Understanding Elementor Structure** ``` Section (Container for layout) └─ Column (Division within section) └─ Widget (Actual content element) ``` ### **Creating Page Layouts** #### **Simple Layout** ``` Create a page with a heading and text widget ``` The AI will: 1. Create section 2. Add column 3. Add heading widget 4. Add text widget 5. Save to page #### **Multi-Column Layout** ``` Create a page with three columns, each containing a heading and text ``` The AI will: 1. Create section 2. Add 3 columns 3. Add widgets to each column 4. Configure column widths #### **Complex Layout** ``` Create a landing page with: - Hero section with full-width background - Features section with 3 columns - Call-to-action section with button ``` The AI will build the complete structure using multiple tools. ### **Working with Sections** #### **Create Section** ``` Add a new section to page ID 456 with a blue background ``` #### **Duplicate Section** ``` Clone the first section from page ID 123 ``` ### **Working with Columns** ``` Add a column to the section with 50% width ``` ``` Create a 3-column layout with equal widths ``` ### **Working with Widgets** #### **Heading Widget** ``` Create a heading widget with text "Welcome to Our Site" as H1 ``` #### **Text Widget** ``` Add a text editor widget with "This is paragraph text" ``` #### **Button Widget** ``` Create a button that says "Learn More" linking to /learn-more ``` #### **Image Widget** ``` Add an image widget using media ID 789 ``` ### **Manipulating Existing Elements** #### **Update Element** ``` Change the background color of section ID abc123 to red ``` #### **Delete Element** ``` Remove the widget with ID xyz789 from page ID 456 ``` #### **Move Element** ``` Move widget ID abc123 to a different position in the layout ``` #### **Clone Element** ``` Duplicate the section with ID def456 ``` ### **Page Structure Analysis** ``` Show me the structure of page ID 123 ``` Returns: - Total sections, columns, widgets - Element hierarchy - Widget types used ### **Templates** (Full Mode) #### **Get Templates** ``` List all Elementor templates ``` #### **Create Template** ``` Create a new template from page ID 123 called "Hero Template" ``` #### **Apply Template** ``` Apply template ID 5 to page ID 789 ``` --- ## 📁 **File Operations** ### **Export Elementor Data** ``` Export the Elementor data from page ID 123 to a file ``` Creates a JSON file with all Elementor data. ### **Import Elementor Data** ``` Import Elementor data from /path/to/elementor-data.json to page ID 456 ``` ### **Backup Operations** #### **Create Backup** ``` Create a backup of page ID 123 with label "Before Redesign" ``` #### **List Backups** ``` Show me all available backups ``` #### **Restore Backup** ``` Restore page ID 123 from backup ID abc-123-xyz ``` ### **File Management** ``` List all Elementor export files ``` ``` Get information about the file at /path/to/export.json ``` ``` Clean up backups older than 30 days ``` --- ## 🔄 **Advanced Workflows** ### **Workflow 1: Clone a Page** ``` Clone the entire layout from page "Homepage" to a new page called "Landing Page" ``` **What happens:** 1. Find source page by slug 2. Get Elementor data 3. Create new page 4. Apply cloned Elementor data 5. Return new page URL ### **Workflow 2: Batch Page Creation** ``` Create 5 service pages with titles: - "Web Development" - "Mobile Apps" - "Cloud Solutions" - "Digital Marketing" - "Consulting" Each should have the same template structure. ``` ### **Workflow 3: Site-Wide Updates** ``` Update all pages to use the new brand color #667eea in their hero sections ``` **What happens:** 1. List all pages 2. Get Elementor data for each 3. Find hero sections 4. Update background colors 5. Save all changes 6. Report results ### **Workflow 4: Content Migration** ``` Export all Elementor pages from the current site, then import them to a new site ``` **Steps:** 1. List all pages 2. Export each page's Elementor data 3. Switch WordPress configuration 4. Create pages on new site 5. Import Elementor data 6. Verify migration ### **Workflow 5: Template-Based Design** ``` Create a template from the "Services" page, then apply it to 10 new pages ``` --- ## ✅ **Best Practices** ### **1. Always Work with Drafts First** When creating or significantly updating pages, use `draft` status: ``` Create a draft page called "New Feature" so I can review it before publishing ``` ### **2. Backup Before Major Changes** ``` Before making changes to page ID 123, create a backup ``` This allows easy rollback if needed. ### **3. Use Descriptive Names** ``` Create a page called "Product Catalog - Electronics" instead of just "Products" ``` ### **4. Test on Staging Sites** If you have a staging site, test major changes there first: ``` Can you switch to my staging site and test this layout? ``` ### **5. Use Chunked Operations for Large Pages** For pages with many elements: ``` Get the Elementor data for page ID 789 in chunks of 5 elements ``` This prevents memory issues and improves performance. ### **6. Regular Backups** ``` Create backups of all main pages weekly ``` ### **7. Clean Up Old Files** ``` Clean up export files and backups older than 60 days ``` --- ## 💡 **Tips and Tricks** ### **Tip 1: Natural Language is Powerful** You don't need to know tool names. Just describe what you want: ✅ **Good:** > "Create a landing page with a hero section, feature grid, and contact form" ❌ **Not necessary:** > "Use create_page then create_section then create_column..." ### **Tip 2: Be Specific** The more details you provide, the better the results: ✅ **Specific:** > "Create a hero section with gradient background from purple (#667eea) to violet (#764ba2), centered heading 'Welcome', and a white button" ❌ **Vague:** > "Make a hero section" ### **Tip 3: Ask for Structure Analysis** Before modifying a page: ``` Show me the structure of page ID 123 ``` This helps you understand what you're working with. ### **Tip 4: Use Page Slugs** Instead of memorizing page IDs: ``` Update the "about-us" page ``` The AI will find the page ID automatically. ### **Tip 5: Batch Operations** For repetitive tasks: ``` Create 3 team member pages with the same layout structure ``` ### **Tip 6: Error Recovery** If something goes wrong: ``` Restore the "homepage" from its most recent backup ``` ### **Tip 7: Testing Changes** ``` Create a test page with the new layout, don't publish it yet ``` ### **Tip 8: Progressive Enhancement** Start simple, then enhance: ``` First, create a basic page with heading and text. Then, add a button and image. Finally, style it with background colors and spacing. ``` --- ## 🔍 **Common Use Cases** ### **Use Case 1: Build Landing Page** ``` Create a landing page at /new-product/ with: - Hero section with image background - 3-column features section - Testimonials section - Call-to-action with button ``` ### **Use Case 2: Update Brand Colors** ``` Update all hero sections across the site to use brand color #667eea ``` ### **Use Case 3: Clone Page for A/B Testing** ``` Clone the "pricing" page to "pricing-variant-b" and change the button color to green ``` ### **Use Case 4: Migrate Content** ``` Export the layout from "old-homepage" and apply it to a new page called "new-homepage" ``` ### **Use Case 5: Bulk Page Creation** ``` Create 20 product pages using data from this CSV file, each with the same Elementor template ``` --- ## 📚 **Learning Path** ### **Beginner** 1. Start with Essential mode 2. Create simple pages with headings and text 3. Learn WordPress CRUD operations 4. Understand Elementor structure ### **Intermediate** 1. Switch to Standard mode 2. Build multi-column layouts 3. Work with different widget types 4. Use export/import features ### **Advanced** 1. Switch to Advanced or Full mode 2. Create complex layouts with containers 3. Work with templates 4. Manipulate existing elements programmatically 5. Use batch operations ### **Expert** 1. Use Full mode with all 60 tools 2. Build complete sites programmatically 3. Create custom workflows 4. Integrate with external data sources 5. Automate site maintenance --- ## 🎓 **Pro Tips from Wordsworth Presley** > 🔧 **"The best layouts start with a clear structure. Plan your sections and columns before adding widgets."** > 🔧 **"Always backup before major changes. The restore_page_data tool is your safety net!"** > 🔧 **"Use descriptive IDs and labels. Your future self will thank you."** > 🔧 **"Start with draft status, review in Elementor editor, then publish. This workflow prevents mistakes."** > 🔧 **"The extract_page_structure tool is your best friend for understanding complex layouts."** --- ## 🚀 **Ready to Build?** Now that you know the basics, start creating! Remember: - **Be descriptive** in your requests - **Start simple** and add complexity gradually - **Use backups** before major changes - **Review in Elementor editor** before publishing - **Ask questions** - the AI is here to help! --- **🔧 Happy building with Ultimate Elementor MCP!** 🚀