Skip to content

Repository files navigation

Novamira

Give your AI agents full access to your WordPress site. Nothing in between.

Website · Documentation · Novamira CLI · Videos · Download · Discord · Facebook Community

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.

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.

Warning

For dev and staging environments. With backups. Always.

Videos

See Novamira in real projects, tutorials, and walkthroughs from the WordPress community.

Watch Novamira videos →

What Novamira provides

  • Full WordPress access through PHP execution, including $wpdb, loaded plugins, themes, and WordPress APIs
  • WP-CLI commands with foreground and background execution
  • Filesystem inspection and editing, plus a recoverable sandbox for new PHP files
  • Native Block Editor workflows, media uploads, reusable skills, agent context, and design guidance
  • OAuth and WordPress Application Password authentication
  • Compatibility with Claude, Codex, Cursor, Gemini CLI, Antigravity, VS Code with GitHub Copilot, and other MCP clients
  • Novamira CLI for connecting terminal-based coding agents such as Claude Code, Codex CLI, and Gemini CLI
  • Novamira Visual, an experimental browser workspace where you can watch an agent work in WordPress

Requirements

  • WordPress 6.9 or later
  • PHP 8.0 or later
  • A WordPress administrator account
  • HTTPS for remote connections; local development environments are supported without HTTPS
  • An MCP-compatible AI client, or a terminal-based coding agent using Novamira CLI

Get started

  1. Download the release ZIP.
  2. In WordPress, go to Plugins → Add New → Upload Plugin, upload the ZIP, and activate Novamira.
  3. Open Novamira → Configuration, enable AI Abilities, and follow the instructions for your AI client and authentication method.

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.

See the quick start guide for the complete connection flow.

Using a terminal-based coding agent? Novamira CLI provides a guided connection for Claude Code, Codex CLI, Gemini CLI, and other agents that can run shell commands.

Documentation

Community

Contributing

Read CONTRIBUTING.md before opening a pull request. Every contribution must start with an approved issue.

License

AGPL-3.0-or-later

About

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

Resources

Contributing

Stars

663 stars

Watchers

24 watching

Forks

Releases

Packages

Used by

Contributors

Languages