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

Go to WordPress Admin → Users → Profile
Scroll to Application Passwords
Enter a name (e.g., "Claude Code") and click Add New
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

Tool	Description
`wp_site_info`	Get site name, URL, timezone
`wp_get_posts`	List posts (filter by status, search)
`wp_get_post`	Get single post with full content
`wp_get_pages`	List all pages
`wp_get_media`	List media library items
`wp_get_plugins`	List installed plugins

Writing Content

Tool	Description
`wp_create_post`	Create a new post (draft or published)
`wp_update_post`	Update title, content, status, or excerpt
`wp_delete_post`	Move to trash or permanently delete

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

Variable	Required	Description
`WORDPRESS_URL`	Yes	Your WordPress site URL (e.g., `https://example.com`)
`WORDPRESS_USER`	Yes	WordPress username
`WORDPRESS_APP_PASSWORD`	Yes	Application password (not your login password!)

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

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.

wordpress-mcp