Skip to content
Back to search

novamira

MCP server that gives AI agents full access to WordPress through PHP execution and filesystem operations

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/use-novamira/novamira with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/use-novamira/novamira'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/use-novamira--novamira/badge.svg)](/listings/use-novamira--novamira)

HTML

<a href="/listings/use-novamira--novamira"><img src="/api/listings/use-novamira--novamira/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 110 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://novamira.ai/">
  3. <img src="assets/banner.png" alt="Novamira" />
  4. </a>
  5. </p>
  6. <p align="center">
  7. <strong>Give your AI agents full access to your WordPress site. Nothing in between.</strong>
  8. </p>
  9. <p align="center">
  10. <a href="https://novamira.ai/">Website</a> ·
  11. <a href="https://novamira.ai/docs/">Documentation</a> ·
  12. <a href="https://novamira.ai/cli/">Novamira CLI</a> ·
  13. <a href="https://novamira.ai/video/">Videos</a> ·
  14. <a href="https://novamira.ai/download/">Download</a> ·
  15. <a href="https://discord.gg/novamira">Discord</a> ·
  16. <a href="https://www.facebook.com/groups/novamira">Facebook Community</a>
  17. </p>
  18. Novamira is an open-source WordPress plugin and MCP server that lets AI agents work directly inside WordPress. Agents can run PHP and WP-CLI commands, inspect the database, manage files, understand the active plugins and theme, and build working functionality against the real site.
  19. The connection is direct between your AI client and your WordPress installation. Novamira is not a hosted proxy and your requests do not pass through Novamira servers.
  20. > [!WARNING]
  21. > For dev and staging environments. With backups. Always.
  22. ## Videos
  23. See Novamira in real projects, tutorials, and walkthroughs from the WordPress community.
  24. **[Watch Novamira videos →](https://novamira.ai/video/)**
  25. ## What Novamira provides
  26. - Full WordPress access through PHP execution, including `$wpdb`, loaded plugins, themes, and WordPress APIs
  27. - WP-CLI commands with foreground and background execution
  28. - Filesystem inspection and editing, plus a recoverable sandbox for new PHP files
  29. - Native Block Editor workflows, media uploads, reusable skills, agent context, and design guidance
  30. - OAuth and WordPress Application Password authentication
  31. - Compatibility with Claude, Codex, Cursor, Gemini CLI, Antigravity, VS Code with GitHub Copilot, and other MCP clients
  32. - [Novamira CLI](https://novamira.ai/cli/) for connecting terminal-based coding agents such as Claude Code, Codex CLI, and Gemini CLI
  33. - Novamira Visual, an experimental browser workspace where you can watch an agent work in WordPress
  34. ## Requirements
  35. - WordPress 6.9 or later
  36. - PHP 8.0 or later
  37. - A WordPress administrator account
  38. - HTTPS for remote connections; local development environments are supported without HTTPS
  39. - An MCP-compatible AI client, or a terminal-based coding agent using Novamira CLI
  40. ## Get started
  41. 1. [Download the release ZIP](https://novamira.ai/download/).
  42. 2. In WordPress, go to **Plugins → Add New → Upload Plugin**, upload the ZIP, and activate Novamira.
  43. 3. Open **Novamira → Configuration**, enable AI Abilities, and follow the instructions for your AI client and authentication method.
  44. Use the release ZIP rather than GitHub's automatically generated source archive. The source archive does not include the bundled Composer dependencies required by the MCP server.
  45. See the [quick start guide](https://novamira.ai/quickstart/) for the complete connection flow.
  46. Using a terminal-based coding agent? [Novamira CLI](https://novamira.ai/cli/) provides a guided connection for Claude Code, Codex CLI, Gemini CLI, and other agents that can run shell commands.
  47. ## Read mode
  48. Read mode lets an agent inspect a site through read abilities, with the abilities that change content, files and settings removed. It is production ready, and it is turned on with [Novamira Pro](https://novamira.ai/pro/). The **Novamira → Read Mode** page shows whether it is on, when it was last changed and by whom, and turns it off without needing Pro or a license; `wp novamira read-mode status` and `wp novamira read-mode disable` do the same from WP-CLI. Read mode stays on if Novamira Pro is deactivated or its license expires. While it is on, the Novamira admin-bar entry reads **Novamira · Read Mode** and links to the Read Mode page, and Novamira's admin pages, Chat included, show a notice. Ghost Mode hides all of these from administrators it hides Novamira from.
  49. Read mode is set per site. The setting is read straight from the site's options table, so option filters and object or query caches cannot make it read as off, and a setting that cannot be read keeps read mode on.
  50. While read mode is on:
  51. - Only an allowlist of read abilities can be used, on every request and through every door (MCP, the Novamira REST runner, WordPress core's `wp-abilities/v1`, Novamira Chat, and Novamira Visual). Novamira ships `agent-context`, `discover-abilities`, `get-ability-info`, `execute-ability`, `read-file`, and `list-directory`; Novamira Pro adds its read abilities for posts, terms, users, comments, options, the database schema, and read-only SQL queries, which stay on. On the Read Mode page, an administrator can also allow the read abilities of the Novamira Pro specializations (on until turned off) and the read abilities other plugins declare (off until turned on). Everything else, including `execute-php`, WP-CLI, file writes, uploads, admin access links, skills, Novamira Design, and the Block Editor Queue abilities (including its block type reads), is unregistered or refused.
  52. - The abilities read mode allows are the ones Novamira ships, the ones Novamira Pro adds, and the ones an administrator chooses on the Read Mode page. They are decided once, after all plugins have loaded, and an ability is allowed only when it is registered with exactly the implementation that is expected for it.
  53. - A name alone is not enough: read mode checks that the ability is registered with exactly the callbacks expected for it, as the plain `WP_Ability` class, so an ability another plugin registers under an allowlisted name, re-registers, or changes with a `wp_register_ability_args` filter is refused.
  54. - The abilities that run PHP or WP-CLI commands, `execute-php` and `run-wp-cli`, also refuse in read mode when they are called directly, without going through the registry. Every other ability relies on the checks all abilities share.
  55. - An administrator can allow the abilities that other plugins declare `readonly`, a declaration any provider can make. The option is off by default, and Novamira Pro offers it on the Read Mode page. Turned on, every registered ability outside Novamira's own namespaces that is the plain `WP_Ability` class and carries `readonly` set to true is kept, without checking its callbacks. Novamira cannot verify those declarations, so allowing these abilities means trusting the plugin that registered them.
  56. - The MCP tool list does not change: `discover-abilities`, `get-ability-info`, and `execute-ability` are listed whether read mode is on or off. `discover-abilities` and `get-ability-info` show only the allowed abilities, and `execute-ability` runs only those, refusing anything else with the read-mode message. Any other MCP tool, resource, or prompt on Novamira's MCP servers that is not backed by an allowed ability, including callable tools added through `novamira_mcp_adapter_default_server_config`, is removed before a request is handled.
  57. - No skills are loaded and no skill prompts are registered: `agent-context` returns no skills.
  58. - The agent's instructions contain only the read-mode guidance: the abilities it can use right now, built from the guidance line each allowed ability carries, what it cannot do, that an ability discovery does not list is unavailable because of read mode (not licensing) or, when only the abilities Novamira ships remain because Novamira Pro or its license is not active, that read mode cannot be used as intended and that an administrator can turn it off, and that it must not try to make changes by other means. The `novamira_discover_abilities_instructions` filter is not applied, so custom instructions and add-on additions are left out.
  59. - Novamira Visual does not work: its workspace page is not served and says why, its backend tools refuse every request, every workspace method refuses, and its Gutenberg editor exposes no tool. A workspace that was open before read mode was turned on stops within a few seconds. After read mode is turned off, an editor that already had Novamira Visual open needs to be reloaded.
  60. - Upload links and admin access links are refused, including links created before read mode was turned on.
  61. - The Abilities Hub looks as usual but lists only the read abilities read mode allows: the ones it requires are marked and cannot be turned off, and each of the others can be turned off and on by itself, whatever feature owns it. The Features page shows a notice and cannot be changed: many of its features are not available while read mode is on. An MCP session that is already open over STDIO needs a restart to see a change in the Abilities Hub or in the groups chosen on the Read Mode page.
  62. Read mode allows abilities that do not change a site's content, files or settings. Some of them may still change temporary data while they run, for example by clearing an expired transient, rebuilding a cache or a generated file, or updating a counter, the way WordPress and its plugins do on any request to the site, and other plugins can react to a read through their own hooks, for example by emptying a page cache. In Novamira, readonly means exactly this. The list of abilities allowed in read mode may change over time.
  63. Read mode is not a security feature: it limits what Novamira offers an agent, not what an administrator can do. It does not stop a plugin written to defeat it: any plugin runs with the same privileges as Novamira and can remove its hooks. The agent still signs in as an administrator, and anyone with those credentials can do anything an administrator can, for example through wp-admin or the WordPress REST API. Read mode applies to Novamira: it does not turn off the other tools of the AI client, so a browser or another MCP server can still make changes if they are left enabled. Hooks other plugins attach to an allowed read, such as `wp_before_execute_ability`, still run and can have side effects. Sandbox plugins in `wp-content/novamira-sandbox/` keep running, and WordPress, Novamira, and other plugins still write their own bookkeeping (sessions, cron, transients, last-used timestamps) as usual. On a multisite network, read mode on one site does not stop an agent connected to another site, where read mode is off, from writing to the shared database.
  64. ## Documentation
  65. - [Documentation](https://novamira.ai/docs/)
  66. - [Getting started](https://novamira.ai/docs/getting-started/)
  67. - [Novamira CLI](https://novamira.ai/cli/)
  68. - [Videos](https://novamira.ai/video/)
  69. - [Security and best practices](https://novamira.ai/docs/security/)
  70. - [Connection troubleshooting](https://novamira.ai/docs/connection-troubleshooting/)
  71. - [Changelog](CHANGELOG.txt)
  72. ## Community
  73. - [Discord](https://discord.gg/novamira)
  74. - [Facebook Community](https://www.facebook.com/groups/novamira)
  75. - [GitHub Discussions](https://github.com/use-novamira/novamira/discussions)
  76. ## Contributing
  77. Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request. Every contribution must start with an approved issue.
  78. ## License
  79. [AGPL-3.0-or-later](https://www.gnu.org/licenses/agpl-3.0.html)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.