All-in-One WP Migration MCP Connector

Manage WordPress backups through Claude AI using the Model Context Protocol. Works with any WordPress site that has the All-in-One WP Migration plugin installed and activated — regardless of hosting provider.

Claude AI  ──►  MCP Connector  ──►  All-in-One WP Migration REST API  ──►  WordPress Site

Prerequisites

| Requirement | Notes | |---|---| | Node.js ≥ 18 | For running the connector locally | | All-in-One WP Migration plugin | Installed & activated on your WordPress site | | WordPress Application Password | Generated in WP Admin → Users → Profile → Application Passwords | | Claude Desktop or Claude Code | To connect the MCP server |

Quick Start

1. Install

# Run directly with npx (recommended — no global install needed)
npx all-in-one-wp-migration-mcp-connector

# Or install globally
npm install -g @servmask/all-in-one-wp-migration-mcp-connector

2. Generate a WordPress Application Password

1. Log in to your WordPress admin dashboard
2. Go to Users → Profile
3. Scroll to Application Passwords
4. Enter a name (e.g. "Claude MCP") and click Add New Application Password
5. Copy the generated password — you'll only see it once

3. Configure Claude Desktop

Add this block to your Claude Desktop config file:

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

{
  "mcpServers": {
    "all-in-one-wp-migration": {
      "command": "npx",
      "args": ["-y", "@servmask/all-in-one-wp-migration-mcp-connector"],
      "env": {
        "WP_SITE_URL": "https://your-wordpress-site.com",
        "WP_USERNAME": "your_admin_username",
        "WP_APPLICATION_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Restart Claude Desktop. The connector is now available.

4. Configure Claude Code (CLI)

claude mcp add all-in-one-wp-migration \
  --env WP_SITE_URL=https://your-wordpress-site.com \
  --env WP_USERNAME=your_admin_username \
  --env "WP_APPLICATION_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx" \
  -- npx -y @servmask/all-in-one-wp-migration-mcp-connector

Available Tools

| Tool | Description | |---|---| | list_backups | List all backup files with name, size, date, and type | | export_backup | Trigger a full site export; returns a job ID and download URL | | import_backup | Restore a site from a .wpress file URL | | get_backup_status | Check progress of an ongoing export or import |

Example Prompts

"List all backups on my WordPress site."

"Export a backup of my site, but skip the media files."

"Import the backup from last Tuesday."

"Is my backup export complete yet? The job ID is abc123."

Running Locally (Development)

git clone https://github.com/your-org/all-in-one-wp-migration-mcp-connector.git
cd all-in-one-wp-migration-mcp-connector

npm install

# Configure credentials
cp .env.example .env
# Edit .env with your WordPress site details

npm run dev   # run with tsx (no build step)
# or
npm run build && npm start

Environment Variables

| Variable | Required | Description | |---|---|---| | WP_SITE_URL | Yes | Full URL of your WordPress site (no trailing slash) | | WP_USERNAME | Yes | WordPress admin username | | WP_APPLICATION_PASSWORD | Yes | WordPress Application Password (spaces are stripped automatically) | | AI1WM_SECRET_KEY | No | Optional secret key for additional API security |

Architecture

┌─────────────────────────────────────┐
│            Claude AI                │
│  (Natural Language Interface)       │
└────────────────┬────────────────────┘
                 │ MCP Protocol (stdio)
┌────────────────▼────────────────────┐
│   All-in-One WP Migration           │
│        MCP Connector                │
│  ┌──────────────────────────────┐   │
│  │  Tool Definitions            │   │
│  │  Authentication Handler      │   │
│  │  WordPress REST API Client   │   │
│  └──────────────────────────────┘   │
└────────────────┬────────────────────┘
                 │ HTTPS + Basic Auth
┌────────────────▼────────────────────┐
│         WordPress Site              │
│  All-in-One WP Migration Plugin     │
│  REST API: /wp-json/ai1wm/v1/       │
└─────────────────────────────────────┘

Security Notes

• Credentials are passed as environment variables — never hard-coded
• All communication uses HTTPS + WordPress Application Passwords
• Application Passwords can be revoked at any time from the WordPress admin
• The connector never stores credentials beyond the current process lifetime

Roadmap

• [ ] Export to cloud storage (Google Drive, Dropbox, Amazon S3)
• [ ] Scheduled backup management
• [ ] Multi-site support
• [ ] Backup encryption settings
• [ ] Restore to staging environment

License

MIT License

Acknowledgements

• Inspired by the WordPress.com MCP Connector
• Built on top of All-in-One WP Migration by ServMask
• Powered by Claude AI and the Model Context Protocol