What is Novamira?
Novamira is an open source WordPress plugin and MCP server. It gives an AI agent direct access to a WordPress site: running PHP and WP-CLI commands, reading the database, managing files and building functionality. The connection goes straight from your AI client to your site, with no hosted proxy.
Novamira is an open source WordPress plugin that doubles as an MCP server. Instead of a fixed list of content endpoints, it lets an agent run PHP inside WordPress, so it can work against the real site, its plugins and its theme.
The README states the connection is direct between your AI client and your WordPress installation. Novamira is not a hosted proxy, and requests do not pass through Novamira servers.
What it gives the agent
- PHP execution with access to the database object, loaded plugins, themes and WordPress APIs.
- WP-CLI commands, in the foreground or the background.
- Filesystem inspection and editing, plus a recoverable sandbox for new PHP files.
- Block Editor workflows, media uploads, reusable skills and design guidance.
- OAuth and WordPress Application Password authentication.
Who it is for
Best for
- Developers who want an agent to build working functionality on a dev or staging copy of a site.
- Teams comfortable reviewing PHP an agent writes and restoring from a backup.
- Anyone who wants a site-wide tool rather than a narrow content API.
Not for
- Live production sites. The README warns in a boxed notice: for dev and staging environments, with backups, always.
- Sites below WordPress 6.9 or PHP 8.0, which are the stated minimums.
Read mode and its limit
Read mode removes the abilities that change content, files and settings, leaving read abilities such as reading files and listing directories. The README says it is turned on with Novamira Pro, and also says read mode is not a security feature: it limits what Novamira offers an agent, not what an administrator can do.
Use it with UiChemy
Novamira works on the WordPress side of a site. UiChemy Composer has its own MCP that works on your own WordPress site, and AI to WordPress for agencies covers moving an AI build into an editable site. Click Get Started on uichemy.com.
Connect Novamira MCP: Let an AI Agent Work Inside WordPress to your AI client
Download the release ZIP from novamira.ai, then upload it under Plugins, Add New, Upload Plugin in WordPress.Check the requirements
WordPress 6.9 or later, PHP 8.0 or later, an administrator account, HTTPS for remote connections (local development works without it) and an MCP compatible AI client.
Install the release ZIP
Upload the release ZIP from the Novamira download page and activate it. The README says not to use GitHub's source archive, because it lacks the bundled Composer dependencies the MCP server needs.
Enable AI Abilities
Open Novamira, then Configuration, turn on AI Abilities and follow the instructions shown for your AI client and authentication method.
Terminal agents
For terminal based coding agents the README points to the Novamira CLI for a guided connection. Use a dev or staging site with backups.
Endpoints and ports
https://novamira.ai/download/Release ZIP, not the GitHub source archivehttps://novamira.ai/quickstart/Full connection flow from the READMEhttps://novamira.ai/docs/security/Security and best practicesWhat you can do with it
- Full site access through PHPThe agent runs PHP with the database object and every loaded plugin and theme, so it builds against the real site rather than a narrow API.
- WP-CLI in the loopForeground and background WP-CLI runs cover tasks such as imports, search and replace and plugin management.
- Recoverable sandboxNew PHP files go into a recoverable sandbox folder in wp-content, which limits the damage a bad file can do.
- Two authentication pathsConnect with OAuth or with a WordPress Application Password, depending on what your AI client supports.
- Read modeAn allowlist of read abilities lets an agent inspect a site without the abilities that change it. It is turned on with Novamira Pro.
- No hosted middle layerYour AI client talks to your site directly. The README says requests do not pass through Novamira servers.
Tools it exposes
execute-php
Runs PHP inside WordPress, including database access and loaded plugin APIs. Refused in read mode.
run-wp-cli
Runs WP-CLI commands. Refused in read mode.
read-file
Reads a file from the site.
list-directory
Lists the contents of a directory.
agent-context
Returns context about the site for the agent.
discover-abilities
Lists the abilities available to the agent.
get-ability-info
Shows details for one ability.
execute-ability
Runs a chosen ability.
Frequently asked questions
What is Novamira?
Novamira is an open source WordPress plugin and MCP server. It lets an AI agent run PHP and WP-CLI, inspect the database, manage files and build functionality directly on your WordPress site, using your own AI client.
How do I install Novamira?
Download the release ZIP from the Novamira download page, upload it under Plugins, Add New, Upload Plugin and activate it. Then open Novamira, Configuration, enable AI Abilities and follow the steps for your client. Do not use GitHub's source archive.
Is Novamira safe to use on a live site?
The README says it is for dev and staging environments, with backups, always. It gives an agent PHP execution, so a mistake can break a site. Test on a copy first and keep a backup you can restore.
What does Novamira need to run?
WordPress 6.9 or later, PHP 8.0 or later, an administrator account and an MCP compatible AI client. Remote connections need HTTPS, while local development environments work without it. The README lists these as requirements.
What is Novamira read mode?
Read mode lets an agent inspect a site through read abilities while abilities that change content, files and settings are removed. The README says it turns on with Novamira Pro and is not a security feature, since administrators can still change things elsewhere.
Does Novamira send my site data through its servers?
The README says the connection is direct between your AI client and your WordPress installation, and that Novamira is not a hosted proxy. Requests do not pass through Novamira servers.
What license is Novamira under?
The README lists AGPL-3.0-or-later. That is an open source license, so read its terms before you modify and redistribute the plugin. Novamira Pro is a separate offering described on the vendor site.
What are alternatives to Novamira?
Other WordPress MCP options include Respira WordPress MCP for page builder editing and MCP Abilities Elementor for Elementor pages. Novamira is broader and riskier because it runs PHP, so it suits dev sites.


