WoodMart MCP guide

woodmart-mcp-guide.md

How to run WoodMart AI in Claude Desktop

A short setup guide. You need Node.js installed and the Claude Desktop app.

Step 0. Prepare the site (once per site)

In wp-admin:

1. Install and activate the WoodMart beta theme — https://drive.google.com/file/d/1ZVg-F5qOgkIl5ye7rH_F_g1dg_I5dQ_n/view?usp=sharing (Appearance → Themes → Add New → Upload Theme). The AI abilities ship with this build.
2. Install and activate the MCP Adapter plugin — https://github.com/wordpress/mcp-adapter
3. Install and activate the AI plugin — https://wordpress.org/plugins/ai/
4. Open the AI menu and turn AI on (the main switch), then enable Ability Explorer there.

Step 1. Create an application password

Log in to your site's wp-admin as an Administrator, then go to Users → Profile → scroll to Application Passwords → type the name mcp → Add New → copy the generated password.

This is a separate password just for the connection — not your normal login password. The name mcp is only a label for this password; it is not your username.

For Step 2 you need three things: your site's URL, your WordPress username (the login you sign in with, e.g. admin — not the mcp label above), and this application password.

Step 2. Connect Claude Desktop

Open Settings → Developer → Edit Config, paste the snippet below, and save. Then fully quit and reopen Claude Desktop.

Replace the address, login, and application password with your own. The NODE_TLS_REJECT_UNAUTHORIZED line is needed only for a local site (.local) — remove it otherwise.

{
  "mcpServers": {
    "wood": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://your-site/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "your-login",
        "WP_API_PASSWORD": "application-password",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

Step 3. Add the instructions (skill)

This is the SKILL.md file that teaches the AI how to use the tools correctly. Take it from this gist: https://gist.github.com/seriusokhatsky/4f083250651a53da8f87861201a6ac9f

Download the SKILL.md, put it in a folder named woodmart-mcp, and zip that folder.

In Claude Desktop: Settings → Skills → Create skill → upload the woodmart-mcp folder (as a ZIP).

Step 4. Check

In Claude Desktop, type: "find the home page". If you get back a list of pages, everything works.