MainWP MCP Server

by mainwpio.github.mainwp/mainwp-mcpv1.4.0

Official MainWP MCP server: manage your WordPress sites from Claude, Cursor, Codex, and other AI tools, with previews and approval before destructive changes

29Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install MainWP MCP server

claude mcp add mainwp -e MAINWP_URL='<mainwp-url>' -e MAINWP_USER='<mainwp-user>' -e MAINWP_APP_PASSWORD='<mainwp-app-password>' -- npx -y @mainwp/mcp

{
  "mcpServers": {
    "mainwp": {
      "command": "npx",
      "args": [
        "-y",
        "@mainwp/mcp"
      ],
      "env": {
        "MAINWP_URL": "<mainwp-url>",
        "MAINWP_USER": "<mainwp-user>",
        "MAINWP_APP_PASSWORD": "<mainwp-app-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "mainwp": {
      "command": "npx",
      "args": [
        "-y",
        "@mainwp/mcp"
      ],
      "env": {
        "MAINWP_URL": "<mainwp-url>",
        "MAINWP_USER": "<mainwp-user>",
        "MAINWP_APP_PASSWORD": "<mainwp-app-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "mainwp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mainwp/mcp"
      ],
      "env": {
        "MAINWP_URL": "<mainwp-url>",
        "MAINWP_USER": "<mainwp-user>",
        "MAINWP_APP_PASSWORD": "<mainwp-app-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "mainwp": {
      "command": "npx",
      "args": [
        "-y",
        "@mainwp/mcp"
      ],
      "env": {
        "MAINWP_URL": "<mainwp-url>",
        "MAINWP_USER": "<mainwp-user>",
        "MAINWP_APP_PASSWORD": "<mainwp-app-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MAINWP_URL	yes	—	Address of your MainWP Dashboard, such as https://dashboard.example.com
MAINWP_USER	yes	—	WordPress username of the Dashboard administrator (the login name, not the display name)
MAINWP_APP_PASSWORD	yes	yes	WordPress Application Password for that user, not their login password

Freshness

Active — last maintenance signal 3d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-06 · 3d ago · GitHub
Latest release
2026-10-06 · 3d ago · GitHub · v1.4.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 3d ago · official registry · v1.4.0

FAQ

›How do I install the MainWP MCP server in Claude Code?

Run: claude mcp add mainwp -e MAINWP_URL='<mainwp-url>' -e MAINWP_USER='<mainwp-user>' -e MAINWP_APP_PASSWORD='<mainwp-app-password>' -- npx -y @mainwp/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does MainWP require an API key?

Yes. It expects MAINWP_URL, MAINWP_USER, MAINWP_APP_PASSWORD, of which 1 is a secret.

›Can I use MainWP as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is MainWP in the official MCP registry?

Yes, as io.github.mainwp/mainwp-mcp.