Black Friday20% off ProPlans →
Back to Blog
tutorial
November 22, 2026
3 min read

Connect Claude Desktop to WordPress and Write Posts From a Chat

N
Nagaraj Dev
Plugin Developer & Creator

Not everyone wants a terminal. If you already write with Claude in the Claude Desktop app, you can connect it to WordPress and ask for posts in an ordinary chat. Each one arrives as a formatted draft on your site.

This takes about five steps and one small edit to a config file. You do it once.

What you need

  • WordPress with DocxToWP Pro 1.6.0 or later, licence active.
  • The Claude Desktop app for Windows or Mac.
  • Node.js 18 or later. Run node -v in a terminal to check. If it is missing, install the LTS version from nodejs.org.

Why Node.js? Claude Desktop starts connections from its config file as small programs on your computer. The DocxToWP snippet uses one called mcp-remote, which passes Claude's requests on to your site. npx downloads and runs it for you the first time.

Step 1: Create a key

In WordPress, open DocxToWP Pro → AI Agents:

  1. Switch the connection on and save. It is off by default.
  2. Open the Keys tab and create a key called Claude Desktop.
  3. Copy it straight away. It is shown once.

Step 2: Edit the config

In Claude Desktop, open Settings → Developer → Edit Config. This opens claude_desktop_config.json in your text editor.

Open the Connect apps → Claude Desktop tab in WordPress and copy the snippet. It has your Server URL and key in it already:

{
  "mcpServers": {
    "docxtowp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-site.com/wp-json/docxtowp/v1/mcp",
        "--header",
        "X-API-Key:dwpk_…"
      ]
    }
  }
}

If the file already has other servers, add the "docxtowp": { … } part inside the existing "mcpServers" braces rather than pasting a second copy.

Note the header: X-API-Key: with no space after the colon. On Windows, a header with a space in it can be split in two on its way to mcp-remote, and the key never arrives. This form avoids that.

Step 3: Restart Claude Desktop

Quit Claude Desktop completely. On Windows, also right-click the tray icon and choose Quit, because closing the window leaves it running. Then open it again.

In a new chat, open the tools menu. You should see docxtowp with four tools.

Step 4: Ask for a post

The Prompt library tab in AI Agents has six ready-made prompts. The FAQ Content Creator works well in a chat. Fill in the [BRACKETS] and paste it, or just ask:

Write a post for my site about how to care for a fiddle-leaf fig, about 800
words, with a short FAQ at the end. Check my site's categories first, then
import it as a draft with DocxToWP and give me the edit link.

When Claude asks to use a DocxToWP tool, click Allow. It looks at your site first, writes the post, imports it, and replies with an edit link and a preview link.

Step 5: Review and publish

Open the edit link in your browser, logged in to WordPress. The post is a draft, with real headings, lists and tables, a category and tags from the ones you already have, and the Yoast SEO or Rank Math fields filled in. Check it, change what you need, and publish.

If DocxToWP does not appear

  • Check node -v shows 18 or later.
  • Check the JSON is valid. A missing comma or brace stops Claude Desktop from reading the whole file.
  • Read the log. On Windows it is %APPDATA%\Claude\logs\mcp-server-docxtowp.log, on a Mac ~/Library/Logs/Claude/.
  • A "key" error means the key is wrong, revoked, or belongs to a user who can no longer import. Create a new key and paste it in.

The full list of messages and fixes is in the Claude Desktop set-up guide.

Prefer a terminal or an editor?

The same connection works with Claude Code, which needs only one command, and with Cursor.

The AI agent connection is part of DocxToWP Pro, from $49/year.

Write in Claude. Get a WordPress draft.

Connect Claude Desktop to your site once, then ask for posts in a chat. They arrive formatted, with SEO fields, as drafts you review.

See Pro plans

Frequently asked questions

Claude Desktop starts connections from its config file as small local programs. The snippet uses mcp-remote, which runs with Node.js and passes requests on to your site.

On Windows, a header with a space in it can be split in two on the way to mcp-remote. X-API-Key: has no space, so it arrives intact. DocxToWP accepts either header.

Not yet. Claude on the web, claude.ai in a browser, needs a different kind of connection that DocxToWP does not offer yet. Claude Desktop, Claude Code and Cursor work today.

No. DocxToWP saves every AI import as a draft. Claude cannot publish, edit or delete posts through it.

Related Articles

Import your first Word document in under 60 seconds

Start free. Import a Word document without copy-pasting or rebuilding its formatting. No account, no credit card. Straight from WordPress.org.