WordPress MCP Server

Manage your WordPress site with AI. Create posts, update content, and query your site—all through natural conversation.

What is this?

WordPress MCP is a Model Context Protocol server that connects AI assistants like Claude Code and Cursor to your WordPress site via the REST API.

Instead of switching between your terminal and WordPress admin, just ask:

You: "Create a draft post about our new product launch"
You: "Show me all posts from last week"
You: "Update post 42 to published status"
You: "What plugins are installed on my site?"

Demo

Here's a real conversation showing the draft-to-publish workflow:

You: Create a draft post titled "Why AI Tools Matter for Content Creators"

Claude: I'll create that draft post for you.

✓ Created draft post:
  ID: 142
  Title: Why AI Tools Matter for Content Creators
  Status: draft
  Link: https://your-site.com/?p=142

You: Add some content about productivity and automation

Claude: I'll update the post with content about productivity and automation.

✓ Updated post 142 with new content.

You: Show me my draft posts

Claude: Here are your draft posts:

| ID  | Title                                      | Date       |
|-----|-------------------------------------------|------------|
| 142 | Why AI Tools Matter for Content Creators  | 2026-01-03 |
| 138 | Upcoming Features Preview                  | 2026-01-02 |
| 135 | Team Update Q1                             | 2025-12-28 |

You: Publish post 142

Claude: ✓ Published! Your post is now live at:
https://your-site.com/2026/01/03/why-ai-tools-matter-for-content-creators/

Features

• Full CRUD for Posts - Create, read, update, and delete posts

• Content Management - List pages, media, and plugins

• Search & Filter - Find posts by status, keyword, or date

• Draft Workflow - Create drafts, review, then publish

• Secure Auth - Uses WordPress Application Passwords

Quick Start

1. Install

git clone https://github.com/gaupoit/wordpress-mcp.git
cd wordpress-mcp
uv sync

2. Create a WordPress Application Password

1. Go to WordPress Admin → Users → Profile

2. Scroll to Application Passwords

3. Enter a name (e.g., "Claude Code") and click Add New

4. Copy the generated password (you won't see it again!)

3. Configure Claude Code

Add to your Claude Code MCP config (~/.claude.json):

{
  "mcpServers": {
    "wordpress": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/wordpress-mcp", "wordpress-mcp"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USER": "your-username",
        "WORDPRESS_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx"
      }
    }
  }
}

4. Restart Claude Code

# Quit and restart
claude

Verify with /mcp - you should see "wordpress" listed.

Available Tools

Reading Content

Writing Content

Example Workflows

Blog Publishing

You: "Create a draft post titled 'Getting Started with AI' with an intro paragraph"
You: "Show me my draft posts"
You: "Update post 123 - add a conclusion section"
You: "Publish post 123"

Content Audit

You: "List all draft posts"
You: "Search posts for 'outdated'"
You: "What plugins are currently active?"

Bulk Operations

You: "Show me all posts with 'beta' in the title"
You: "Get the full content of post 45, 46, and 47"
You: "Move posts 45 and 46 to trash"

Environment Variables

Requirements

• Python 3.10+

• WordPress 5.6+ (for Application Passwords)

• WordPress REST API enabled (default on most sites)

Troubleshooting

"Authentication failed"

• Verify your Application Password is correct (no spaces)

• Ensure the user has permission to access REST API

• Check if a security plugin is blocking REST API

"Connection refused"

• Verify WORDPRESS_URL includes https://

• Check if your site is behind a firewall/VPN

Server not appearing in Claude Code

• Run /mcp to see error messages

• Test manually: cd wordpress-mcp && uv run wordpress-mcp

• Restart Claude Code completely (/quit then claude)

Roadmap

• Categories and tags management

• User management

• Custom post types support

• Media upload

• Comments management

• WooCommerce integration

Contributing

Contributions welcome! Please open an issue first to discuss what you'd like to change.

License

MIT

Built with FastMCP and the WordPress REST API.