Connect Claude Desktop to WordPress and Write Posts From a Chat
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 -vin 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:
- Switch the connection on and save. It is off by default.
- Open the Keys tab and create a key called Claude Desktop.
- 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 -vshows 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 plansFrequently 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
How to Connect Claude to WordPress With MCP, Step by Step
Connect Claude Code, Claude Desktop or Cursor to your own WordPress site with DocxToWP's MCP server. Ask for a post and get a formatted draft with categories, tags and Yoast SEO fields, ready for you to review and publish.
Write WordPress Posts in Cursor and Send Them as Drafts
Keep your blog posts as Markdown in a Cursor project and send them to WordPress from the Agent chat. Add DocxToWP to mcp.json once, and every post arrives as a formatted draft.
Import Word Documents With the Yoast SEO Title and Meta Description Filled In
Write the SEO title, meta description and URL slug at the top of your Word draft, and have them land in Yoast SEO or Rank Math when you import, instead of in the post. One document or a hundred.
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.