How to Connect Claude to WordPress Using Novamira

Deep Dive WordPress × AI · 14 min read

I Connected Claude AI to WordPress Using Novamira — and It Rewired How I Work

One developer. No agency. Full agency-level output. Here’s the exact setup I use to deliver WordPress projects faster, smarter, and at a standard that used to require a team.

Faster delivery
9 AI tools in one connection
Free To get started
WP 6.9+ Required

The problem every solo WordPress developer knows

You quote a project. The client wants it done in two weeks. The scope includes a custom plugin, a checkout flow, three page templates, and integration with a payment gateway. You can do it — but just barely, and only if nothing goes wrong.

Clients don’t care that you’re one person. They care that their site works, looks great, and gets delivered on time. The standard they’re comparing you against isn’t “best freelancer” — it’s the agency down the street with five developers.

I’ve been in that position for years. And until recently, the honest answer was: you grind, you cut sleep, you under-charge to compensate for your slower pace. You survive on caffeine and customer goodwill.

That changed the day I connected Claude AI directly to my WordPress sites using a plugin called Novamira.

“This isn’t a writing assistant that helps you draft blog posts. This is an AI that can read your database, execute PHP, install plugins, and iterate on your code — inside a conversation.”

Let me show you exactly what that means, and how to set it up step by step.


What is Novamira — and why should you care?

Novamira is a free WordPress plugin built by the team behind Dynamic Content for Elementor. It turns your WordPress site into an MCP server — a Model Context Protocol server — which is the open standard that lets AI models like Claude connect to external tools and live data.

Before Novamira, asking an AI to help with WordPress meant copying code out of Claude, pasting it into your site, watching it break, copying the error back, and repeating. The AI was always flying blind. It couldn’t see your database. It didn’t know what plugins were active. It had no idea what your custom post types looked like at runtime.

With Novamira, Claude operates inside your WordPress environment. It sees what you see. It can query your database directly. It can run PHP with the full WordPress environment loaded — $wpdb, all functions, all active plugins. It can read and write files. It can test its own output and iterate without you manually copying anything.

⚠ Important

Novamira is designed for development and staging environments — not live production sites. Always keep backups. This tool gives an AI agent substantial access to your WordPress installation, which is exactly why it’s powerful and exactly why you should use it carefully.

The 9 abilities Claude gets through Novamira

Execute PHP
Runs PHP with the full WordPress environment. $wpdb, all hooks, all active plugins — live.
📖
Read File
Reads any file from your server filesystem, with support for partial reads and binary files.
✏️
Write File
Creates or overwrites files. PHP files are sandboxed to the Novamira sandbox directory.
🔧
Edit File
Targeted string replacement in existing files — the same way AI code editors work.
🗑️
Delete File
Deletes files or directories when you give the instruction.
⏸️
Disable / Enable File
Temporarily disables sandbox files without deleting them — a safe way to test rollbacks.
📁
List Directory
Lists directory contents with glob filtering and recursive traversal.
🔗
Create Upload Link
Creates a temporary URL so Claude can upload plugins, themes, or media directly to your site.

That’s not an AI assistant. That’s a junior developer who never sleeps, never makes typos twice, and doesn’t bill by the hour.


What you need before you start

No jargon, no guesswork. Here’s the complete checklist:

🌐

WordPress 6.9 or newer

Novamira uses the WordPress Abilities API, which was introduced in WordPress 6.9. Check your version at Dashboard → Updates.

🔒

HTTPS on your site (or a local dev flag)

WordPress Application Passwords require HTTPS. For local development, add define( 'WP_ENVIRONMENT_TYPE', 'local' ); to your wp-config.php. That unlocks Application Passwords without HTTPS.

💻

Node.js installed on your computer

This is what runs the MCP bridge between Claude and your WordPress site. Get it free at nodejs.org — download the LTS version. Once installed, open a terminal and type node -v. You should see a version number.

🤖

Claude Desktop or Claude Code

These are the two Claude clients that support MCP connections. Claude Desktop is the easier starting point for most developers. Download it at claude.ai/download.


Complete setup guide — step by step

Follow these in order. Every step builds on the last. No skipping.

1

Install Node.js

Go to nodejs.org, click the big green LTS button, and run the installer. Default settings are fine. After installation, open Terminal (Mac/Linux) or Command Prompt (Windows) and type node -v. You should see something like v20.11.0. If you see that, you’re done with this step.

2

Download and install the Novamira plugin

Go to novamira.ai/download and download the free ZIP file. In your WordPress admin, go to Plugins → Add New Plugin → Upload Plugin. Select the ZIP and click Install Now, then Activate Plugin. You’ll see a new “Novamira” item appear in your admin sidebar. That’s your confirmation it worked.

3

Enable AI abilities

Go to Novamira → Settings. Check the Enable AI Abilities checkbox. A security dialog appears — read it, then click OK, then Save Settings. You’ll now see a red Novamira ON badge in your admin bar. That’s your visual reminder that AI access is active. Turn this off when you’re not actively using it.

4

Create an Application Password

Go to Novamira → Connect. Under Application Passwords, type a label (e.g. “Claude Dev”) and click Create New Application Password. A password appears — copy it immediately. It will never be shown again. This password is what Claude uses to authenticate with your site. Do not share it.

5

Connect Claude using the auto-setup prompt

Still on the Novamira → Connect page, click Copy prompt. Open Claude Desktop or Claude Code. Start a new conversation. Paste the prompt in. Claude reads your connection details and writes its own MCP config file for you. When Claude asks you to restart, restart the app. You’re connected.

6

Verify the connection works

Start a fresh conversation and ask Claude: “List all the plugins installed on this WordPress site.” Claude will call the Execute PHP tool, run a query against your database, and return the list. If you see your plugins, the connection is live and fully working.

Manual config (if auto-setup doesn’t work)

If Claude can’t write its own config — this sometimes happens in restricted environments — expand the “Need the JSON config?” section on the Connect page and copy the ready-made snippet. Paste it into Claude Desktop’s config file. Here’s what it looks like:

Claude Desktop — MCP config (claude_desktop_config.json)
{
  "mcpServers": { "novamira": { "command": "npx", "args": ["-y", "@automattic/mcp-wordpress-remote@latest"], "env": { "WP_API_URL": "https://yoursite.com/wp-json/mcp/novamira", "WP_API_USERNAME": "your-wordpress-username", "WP_API_PASSWORD": "the-password-you-copied-in-step-4" }
    }
  }
}

Replace the three values. Save the file. Restart Claude Desktop. That’s it.


Troubleshooting — every error explained

Error What it means Fix
Application Passwords require HTTPS Your site doesn’t have SSL Add define( 'WP_ENVIRONMENT_TYPE', 'local' ); to wp-config.php
Connection refused AI abilities are still off Go to Novamira → Settings and enable AI Abilities
Authentication failed Wrong username or password WordPress usernames are case-sensitive. Generate a fresh Application Password and update your config
npx: command not found Node.js isn’t installed or isn’t in your PATH Reinstall Node.js from nodejs.org — use the LTS version
Tools not showing in Claude Claude loaded before the config was updated Fully quit and relaunch Claude Desktop — not just close the window

How this changes the economics of solo WordPress development

Let me be direct with you. This isn’t about cool tech demos. It’s about money, speed, and client confidence.

When a client asks me to build a custom WooCommerce checkout with bKash and Nagad integration, I don’t spend two days manually writing and debugging payment handler code. I describe the architecture to Claude, it queries my existing plugin structure, writes the handler inside WordPress, tests it, catches the edge cases I would have caught on day three, and hands me back working code inside one conversation.

I still review every line. I still own every decision. But the grunt work — the boilerplate, the database queries, the hook registrations — happens at a speed that’s structurally impossible to match by hand.

The Competitive Edge

Agencies charge premium prices because they have redundancy — multiple developers cross-checking each other’s work. With Novamira, you have an AI that cross-checks its own work in real time, inside your actual WordPress environment. You get redundancy without the headcount.

What this means for your clients

Your clients don’t know or care about MCP protocols. What they see is that you deliver in half the expected time, you catch problems before they report them, and you give confident, specific answers instead of “let me look into that.”

That’s the agency experience. And now one developer can deliver it.

What this means for your pricing

The old model: charge by hours worked. The new model: charge by value delivered. When you can do in 4 hours what used to take 12, you don’t charge 4 hours of your rate. You charge the value of the outcome — the custom plugin, the integration, the result. That’s where the margin lives.

“The developer who adopts the right tools first doesn’t work harder than everyone else. They just win the clients everyone else is competing for.”


Frequently asked questions

Is Novamira safe to use?

On a development or staging site, yes — with the same discipline you’d apply to any powerful tool. Novamira is explicit about this: it’s not for live production sites. It sandboxes PHP file writes. Every tool call requires your approval before Claude runs it. You stay in control of every action.

Do I need to pay for Novamira?

The free version covers everything in this guide — all nine AI tools, full MCP connection, Application Password auth. There’s a Pro tier (€49/year) that adds AI memory and deeper integrations with Elementor and Bricks. Start free. Upgrade if you need it.

Which version of Claude should I use?

For this kind of technical, iterative work — Claude Sonnet is the sweet spot. It’s fast, follows instructions precisely, and handles long technical context without going off track. Use it for the actual WordPress development conversations.

Can I use this with Cursor or VS Code instead of Claude Desktop?

Yes. Novamira works with any MCP-compatible client: Claude Code, Claude Desktop, Cursor, VS Code (via Copilot), Windsurf, Zed, and OpenCode. The Connect page in your WordPress admin shows the exact config for each one.

What happens if Claude makes a mistake?

Claude shows you each tool call before executing it — you approve or reject. If something goes wrong, Novamira has crash recovery built in. And because you’re working on a staging environment (you are working on a staging environment), nothing touches your live site until you’ve verified it manually.

Is this cheating?

No. Using a linter isn’t cheating. Using version control isn’t cheating. Using a tool that makes you faster and more accurate is called being a professional. Your clients are paying for results, not for the number of keystrokes it took to produce them.


Need agency-level WordPress work?

Custom plugins, payment integrations, automation systems — built to production standards. One developer, full accountability, no project management overhead.

R
Rizwan
WordPress Engineer · Rajshahi, Bangladesh

I build production-grade WordPress plugins and automation systems for clients across South Asia and beyond. Specialising in custom plugin architecture, BD payment integrations (bKash, Nagad, Rocket, bank transfer), and AI-powered development workflows. One developer. Agency standards.

© 2026 Rizwan · WordPress Engineer. All rights reserved.

Connect Claude to WordPress Using Novamira in Brief

⚠️ Warning: Use this on a development or staging site only — never on a live production site. Always keep a backup.

Before You Start — Requirements

You need:

  • WordPress 6.9 or newer
  • Your site must use HTTPS (or be a local dev site — more on that below)
  • Claude Desktop or Claude Code installed on your computer
  • Node.js installed on your computer (needed to run the MCP bridge)

Step 1 — Install Node.js

Go to https://nodejs.org, download the LTS version, and install it. This is required for the MCP bridge to work. Once installed, you can confirm it worked by opening a terminal and typing node -v. You should see a version number.


Step 2 — Download and Install the Novamira Plugin

  1. Go to https://novamira.ai/download/ and download the free ZIP file.
  2. Log in to your WordPress admin panel.
  3. Go to Plugins → Add New Plugin → Upload Plugin.
  4. Select the ZIP file and click Install Now, then click Activate Plugin.

After activation, a Novamira menu item will appear in the WordPress admin sidebar.


Step 3 — Enable AI Abilities

By default, AI abilities are disabled — no tools are exposed until you explicitly turn them on.

  1. In your WordPress admin, go to Novamira → Settings.
  2. Check the Enable AI Abilities checkbox.
  3. A warning dialog will appear — click OK to confirm, then click Save Settings.

Once enabled, a red Novamira ON indicator appears in the WordPress admin bar as a persistent reminder that AI abilities are active.


Step 4 — Create an Application Password

Application Passwords are a WordPress feature that lets external applications authenticate without using your main login password.

  1. In the WordPress admin, go to Novamira → Connect.
  2. Under Application Passwords, optionally enter a name (defaults to “Novamira”) and click Create New Application Password.
  3. Copy the password immediately — it will not be shown again after you leave the page.

If your site is local (no HTTPS), add this line to your wp-config.php file:

define( 'WP_ENVIRONMENT_TYPE', 'local' );

Step 5 — Connect Claude to Your Site

This is the easiest part. The Novamira → Connect page generates a setup prompt that contains your connection URL, username, application password, and the rules your AI client needs to write its own config.

  1. On the Novamira → Connect page, click Copy prompt.
  2. Open Claude Desktop or Claude Code.
  3. Paste the prompt into a new conversation. The agent reads the details and writes the MCP server config for you. Restart or reload the MCP session when it asks.

That’s it — Claude writes its own config file automatically.


Step 5 (Alternative) — Manual Config

If the auto-setup doesn’t work, you can configure Claude manually. Expand Need the JSON config for a specific client? on the Connect page to copy a ready-made snippet, then paste it into Claude Desktop’s config file (claude_desktop_config.json). It looks like this:

{
  "mcpServers": {
    "novamira": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://your-site.com/wp-json/mcp/novamira",
        "WP_API_USERNAME": "your-wordpress-username",
        "WP_API_PASSWORD": "the-password-you-copied-in-step-4"
      }
    }
  }
}

Replace the three values with your actual site URL, your WordPress username, and the application password from Step 4.


Step 6 — Verify It Works

After configuring your AI client, start a new session and look for the Novamira tools in your client’s tool list.

Try this test: ask Claude — “List the plugins installed on this WordPress site.” It should use the Execute PHP tool to run a query and return the list of active plugins. If it does, everything is working.


Quick Troubleshooting

Problem Fix
"Application Passwords require HTTPS" Add define( 'WP_ENVIRONMENT_TYPE', 'local' ); to wp-config.php
Connection refused Make sure AI abilities are enabled in Novamira → Settings
Authentication failed Double-check your WordPress username (it’s case-sensitive) and the copied password
"npx: command not found" Node.js is not installed — go back to Step 1
Tools not showing in Claude Fully restart Claude Desktop after adding the config

Similar Posts