plesk-mcp — Claude Code MCP server: what it does, how to install
Connects AI assistants to Plesk hosting instances via REST APIs and shell access. Lets you administer servers and transfer files directly from your workspace.
claude mcp add --env PLESK_HOST=<PLESK_HOST> --env PLESK_API_KEY=<PLESK_API_KEY> --env PLESK_USERNAME=<PLESK_USERNAME> --env PLESK_PASSWORD=<PLESK_PASSWORD> --transport stdio plesk-mcp -- uvx plesk-mcpWhat plesk-mcp does
The MCP server links your coding agent to Plesk on Linux or Windows. It communicates through the Plesk REST API alongside WP Toolkit endpoints to handle routine server operations. The server executes locally on your machine, so credentials stay within your private environment. Agents can trigger shell commands and upload files straight to the remote machine.
Running the tool requires Python's uv package installer. Connection details pass through environment variables: PLESK_HOST with an address and PLESK_API_KEY generated via plesk bin secret_key. Alternatively, standard administrator username and password parameters work. An --insecure option handles self-signed certificates.
Without enabled REST API access on the hosting panel, requests will fail immediately. The author tested the integration against Plesk Obsidian 18.0.76. You can attach multiple instances simultaneously or test against the official plesk/plesk container before touching production.
What it helps with
- execute shell commands on remote Plesk hosts
- transfer configuration files directly to hosting servers
- manage sites using Plesk and WP Toolkit REST APIs
- administer multiple Plesk installations from one environment
Example prompts for the agent
- Check the server status using Plesk REST API
- Upload
nginx.confto my Plesk hosting instance - Run a shell command on the Plesk server to inspect disk usage
How to install plesk-mcp
Platform CLI
claude mcp add --env PLESK_HOST=<PLESK_HOST> --env PLESK_API_KEY=<PLESK_API_KEY> --env PLESK_USERNAME=<PLESK_USERNAME> --env PLESK_PASSWORD=<PLESK_PASSWORD> --transport stdio plesk-mcp -- uvx plesk-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from plesk-mcp <command>
Platform CLI
codex mcp add plesk-mcp --env PLESK_HOST=<PLESK_HOST> --env PLESK_API_KEY=<PLESK_API_KEY> --env PLESK_USERNAME=<PLESK_USERNAME> --env PLESK_PASSWORD=<PLESK_PASSWORD> -- uvx plesk-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from plesk-mcp <command>
Config file
{
"mcpServers": {
"plesk-mcp": {
"command": "uvx",
"args": [
"plesk-mcp"
],
"env": {
"PLESK_HOST": "<PLESK_HOST>",
"PLESK_API_KEY": "<PLESK_API_KEY>",
"PLESK_USERNAME": "<PLESK_USERNAME>",
"PLESK_PASSWORD": "<PLESK_PASSWORD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from plesk-mcp <command>
Config file
{
"servers": {
"plesk-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"plesk-mcp"
],
"env": {
"PLESK_HOST": "<PLESK_HOST>",
"PLESK_API_KEY": "<PLESK_API_KEY>",
"PLESK_USERNAME": "<PLESK_USERNAME>",
"PLESK_PASSWORD": "<PLESK_PASSWORD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from plesk-mcp <command>
Platform CLI
gemini mcp add -e PLESK_HOST=<PLESK_HOST> -e PLESK_API_KEY=<PLESK_API_KEY> -e PLESK_USERNAME=<PLESK_USERNAME> -e PLESK_PASSWORD=<PLESK_PASSWORD> plesk-mcp uvx plesk-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from plesk-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about plesk-mcp
How to install plesk-mcp in Claude Code?
Run `claude mcp add --env PLESK_HOST=<PLESK_HOST> --env PLESK_API_KEY=<PLESK_API_KEY> --env PLESK_USERNAME=<PLESK_USERNAME> --env PLESK_PASSWORD=<PLESK_PASSWORD> --transport stdio plesk-mcp -- uvx plesk-mcp with your server parameters. You can also run claude mcp add plesk-mcp -- uvx plesk-mcp`.
What prerequisites are needed for plesk-mcp?
You need uv on your local machine to launch the server via uvx. The remote Plesk installation must have REST API access enabled, along with a secret key or admin credentials.
Can I test plesk-mcp without a live production host?
Yes. You can spin up a local instance using the plesk/plesk Docker image. The package also supports running in demo mode from repository sources with mocked data.
