WordPress MCP Server

A Model Context Protocol (MCP) server that lets Claude manage WordPress sites through the WordPress REST API.

---

We've Reinvented Contributing

Every issue in this repo is AI-Ready — structured with full context, file paths, implementation guides, acceptance criteria, and a ready-to-use AI prompt at the bottom.

Pick an issue. Copy the prompt. Paste into your AI tool. Submit a PR.

No codebase knowledge required. No onboarding docs to read. Just pick an issue and go.

Browse Issues →

---

Features

• Posts: Create, read, update, delete, publish, search
• Categories & Tags: List and filter taxonomies
• Site Info: Query site configuration and capabilities
• Application Passwords: Secure auth without hardcoded credentials
• Docker Ready: Multi-stage build, non-root, production-hardened

Quick Start

git clone https://github.com/wolffcatskyy/wordpress-mcp.git
cd wordpress-mcp
npm install
cp .env.example .env
# Edit .env with your WordPress URL and Application Password
npm run build
npm start

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "wordpress": {
      "command": "node",
      "args": ["/path/to/wordpress-mcp/dist/index.js"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Configuration

Variable	Required	Description
WORDPRESS_URL	Yes	WordPress site URL (e.g., https://your-site.com)
WORDPRESS_USERNAME	Yes	WordPress admin username
WORDPRESS_PASSWORD	Yes	Application Password (generate in WP Admin > Users > Profile)
LOG_LEVEL	No	debug, info, warn, error (default: info)

Authentication Setup

This server uses WordPress Application Passwords (built into WordPress 5.6+):

1. Go to WordPress Admin > Users > Your Profile
2. Scroll to Application Passwords
3. Enter name: Claude MCP
4. Click Add New Application Password
5. Copy the generated password (spaces are fine)
6. Use it as WORDPRESS_PASSWORD in your config

Available Tools

Tool	Description
get_posts	List posts with filtering (search, status, pagination, ordering)
get_post	Get a single post by ID
create_post	Create a new post (title, content, excerpt, status, categories, tags)
update_post	Update an existing post
delete_post	Delete/trash a post
publish_post	Publish a draft or pending post
get_categories	List categories with optional search
get_tags	List tags with optional search
get_site_info	Get site name, description, URL, timezone, capabilities

Docker

# Build and run
docker compose up -d

# View logs
docker logs wordpress-mcp

Development

npm run dev    # Run with tsx (hot reload)
npm run build  # Compile TypeScript
npm start      # Run compiled JS

Project Structure

src/
|-- index.ts          # MCP server entry point, tool definitions, request handlers
|-- wordpress.ts      # WordPress REST API client (posts, categories, tags, site)
|-- utils/
    |-- logger.ts     # Structured JSON logging to stderr

Contributing

See CONTRIBUTING.md for how to help -- including using AI tools to tackle open issues.

Acknowledgments

Built with Claude and Perplexity.

License

MIT -- see LICENSE