WordPress Elementor MCP Server

MCP server for managing WordPress Elementor pages via the WordPress REST API.

Setup

1. Install dependencies:

   npm install

2. Configure WordPress sites:

   Copy .env.example to .env:

   cp .env.example .env

   Edit .env and add your WordPress site details:

   WP_SITE_1_URL=https://yoursite.com
   WP_SITE_1_USERNAME=admin
   WP_SITE_1_APP_PASSWORD=your-app-password-here
   

   For multiple sites, add more entries:

   WP_SITE_2_URL=https://anothersite.com
   WP_SITE_2_USERNAME=admin
   WP_SITE_2_APP_PASSWORD=another-app-password
   

3. Generate WordPress Application Password:

   • Log into your WordPress admin panel
   • Go to Users → Profile
   • Scroll to "Application Passwords"
   • Create a new application password
   • Copy the generated password (format: xxxx xxxx xxxx xxxx xxxx xxxx)

Usage

Running the server

npm start

Configure in Claude Desktop

Add to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wordpress-elementor": {
      "command": "node",
      "args": ["C:\\Users\\spenc\\WebstormProjects\\elementor-mcp\\index.js"]
    }
  }
}

Available Tools

1. list_sites

List all configured WordPress sites.

2. list_pages

List pages from a WordPress site.

Parameters:

• site_id (required): Site ID (e.g., 'site1')
• per_page (optional): Number of pages (default: 10, max: 100)
• search (optional): Search term

3. get_page

Get details of a specific page.

Parameters:

• site_id (required): Site ID
• page_id (required): WordPress page ID

4. create_page

Create a new WordPress page with Elementor.

Parameters:

• site_id (required): Site ID
• title (required): Page title
• status (optional): Page status (draft, publish, pending, private)
• elementor_data (optional): Elementor JSON data

5. update_page

Update an existing page.

Parameters:

• site_id (required): Site ID
• page_id (required): WordPress page ID
• title (optional): New title
• status (optional): New status
• elementor_data (optional): Updated Elementor JSON data

6. get_elementor_data

Get Elementor-specific metadata for a page.

Parameters:

• site_id (required): Site ID
• page_id (required): WordPress page ID

WordPress REST API Setup

Ensure your WordPress site has:

1. REST API enabled (enabled by default)
2. Application Passwords enabled (WordPress 5.6+)
3. Elementor plugin installed

Security

• Never commit .env file (it's in .gitignore)
• Application passwords are stored locally only
• Use HTTPS URLs for production sites