> ## Documentation Index > Fetch the complete documentation index at: https://docs.mainwp.com/llms.txt > Use this file to discover all available pages before exploring further. # MainWP Control > Use the MainWP Control CLI to script and automate MainWP Dashboard operations from the command line. This page is a high-level overview. For installation steps, command reference, workflow examples, releases, and the latest updates, use the official [mainwp/mainwp-control](https://github.com/mainwp/mainwp-control) repository. View the README, releases, issue tracker, and the latest usage examples. MainWP Control is the command-line interface for MainWP Dashboard. It lets you work with your Dashboard from a terminal so you can inspect sites, check updates, run abilities, and automate routine tasks in scripts, cron jobs, and CI/CD pipelines. Unlike the [MainWP MCP Server](/mcp-server/overview), which is designed for AI assistants and MCP clients, MainWP Control is designed for direct command-line use. Both tools use the [Abilities API](/api-reference/abilities-api/overview) and follow the same safety model for protected actions. ## What You'll Learn * What MainWP Control is * When to use it instead of the MCP Server * Basic requirements and a simple starting point * Where to find the authoritative documentation ## Prerequisites * Node.js 20.18.1 or later * MainWP Dashboard 6 or later * WordPress 6.9 or later on the Dashboard for the Abilities API * A WordPress user account with permission to perform the actions you need * A WordPress Application Password for that user *** ## Common Use Cases * Run scheduled maintenance or reporting tasks from cron * Use MainWP operations inside CI/CD pipelines and deployment scripts * Query your Dashboard and return JSON output for other tools * Run bulk or batch-friendly workflows from the command line ## How MainWP Control Works MainWP Control connects to your MainWP Dashboard and exposes its available operations through the `mainwpcontrol` command. In practice, that means you can sign in once, discover the abilities your Dashboard makes available, and then run those abilities directly from the terminal. This is useful when you want a repeatable workflow instead of a browser-based process. For example, you can script routine checks, pass JSON output to other tools, and build scheduled jobs around the same Dashboard actions you already use in MainWP. *** ## Typical Workflow ### Guided Setup in MainWP Dashboard MainWP Dashboard 6.3 adds **MainWP > AI > MainWP Control**. The page has four steps and lets you create an Application Password without leaving it. Access to this setup page requires a WordPress administrator account with `manage_options`. In **Credentials**, click **Create Application Password**, review the prefilled name, and click **Create**. Save the generated password before closing the success dialog. Select **Install**, then click **Copy to clipboard** for the installation and login commands. Run them on the computer or server where you will use MainWP Control. Login asks for the Dashboard URL, the WordPress username that owns the password, and the Application Password. Select **Test** and copy `mainwpcontrol abilities list` and `mainwpcontrol abilities run list-sites-v1 --json`. Run them in your terminal and check the returned sites. Select **Finish** for links and reminders about profiles, structured output, previews, confirmation, and credentials. The MainWP Control guided setup page with installation and login commands The page supplies editable commands. It does not run them, install the CLI, or verify the connection for you. The **Connect an AI tool** panel in the password dialog is for MainWP MCP clients; continue with the Control page's **Install** and **Test** steps for the CLI. ### Terminal Setup MainWP Control installs as the `mainwpcontrol` command. A common starting flow is: ```bash theme={null} npm install -g @mainwp/control mainwpcontrol login mainwpcontrol abilities list ``` After you connect to your Dashboard, you can inspect the abilities your Dashboard exposes and run the ones you need. The upstream README documents the latest login options, command groups, flags, and examples. MainWP Control also supports multi-dashboard workflows through profiles, which helps when you manage separate staging and production Dashboards. Output can be returned as JSON, making it practical for shell scripts, monitoring, and CI/CD jobs. ## Login, Timeouts, and Output ### Login Without the CLI Password Prompt `mainwpcontrol login` uses `MAINWP_APP_PASSWORD` instead of prompting for a password when that environment variable is set. Also set `MAINWP_DASHBOARD_URL` to the Dashboard the password belongs to, and provide the matching URL and username with `--url` and `--username`. See the [environment-variable authentication guide](https://github.com/mainwp/mainwp-control/blob/main/docs/configuration.md#environment-variable-auth) for setup instructions. If login reports that credentials were not saved to the system keychain, keep both variables available for subsequent commands. ### Adjust the HTTP Request Timeout The default HTTP request timeout is 30 seconds. If a request times out, you can increase the `timeout` value in `settings.json`. The value is in milliseconds; for example, 120000 allows up to 120 seconds per request: ```json theme={null} { "timeout": 120000 } ``` Add or update this property without removing other settings. The default file location is `.config/mainwpcontrol/settings.json` under your home directory. If `XDG_CONFIG_HOME` is set, the file is in `mainwpcontrol/settings.json` under that directory instead. Run `mainwpcontrol config show` to inspect the active settings. See the [settings file reference](https://github.com/mainwp/mainwp-control/blob/main/docs/configuration.md#settings-file) for details. ### Read Update Results `--json` produces structured output for scripts and other tools to process. Omitting `--json` from `abilities run` still displays the result as JSON; it does not convert update results into a table. When building a report with `list-updates-v1`, retrieve every page using `page` and `per_page`. The `total` field counts all matching updates, so it can be larger than the number of entries in the current page's `updates` array. Check any returned `errors` before treating a report as complete. Use `mainwpcontrol abilities info list-updates-v1` to inspect the input schema available on your Dashboard. The update list reflects information already stored in the Dashboard; listing updates does not perform a fresh site sync. ## MainWP Control vs MCP Server Use MainWP Control when you want: * A CLI for scripts, scheduled jobs, and shell-based automation * Structured command output, including JSON, for pipelines and monitoring * Explicit commands instead of natural-language prompts Use the [MainWP MCP Server](/mcp-server/overview) when you want: * Claude, Cursor, OpenAI Codex, VS Code Copilot, or another MCP client to call MainWP tools * Conversational access to MainWP through an AI assistant ## Safety Model MainWP Control uses the same MainWP ability model as the MCP Server. Read-only operations can be run directly, while protected or destructive actions are designed to require an explicit preview-and-confirm flow. This makes the CLI a better fit for automation than ad hoc browser actions, because you can build repeatable workflows around clear command behavior. *** ## Related Resources * [MainWP Control on GitHub](https://github.com/mainwp/mainwp-control) * [Abilities API Overview](/api-reference/abilities-api/overview) * [MainWP MCP Server](/mcp-server/overview) * [Application Passwords](/api-reference/rest-api/application-passwords) * [AI Menu](/dashboard/overview/mainwp-ai) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.