home / mcp / wordpress author mcp server

WordPress Author MCP Server

Provides role-based WordPress management via MCP with semantic operations and document sessions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aaronsb-wordpress-mcp": {
      "command": "node",
      "args": [
        "/path/to/wordpress-mcp/src/server.js",
        "--personality=author"
      ],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

You are using a WordPress Author MCP Server that translates your natural language intents into WordPress actions, while keeping editing flows clean, secure, and version-controlled. It provides personality-based tool mappings, semantic operations, and a document session workflow so you can draft, edit, publish, and manage WordPress content with AI-assisted productivity.

How to use

You interact with the WordPress Author MCP Server through a client that supports MCP. Choose the Author personality to get full authoring capabilities, including drafting, editing, publishing, scheduling, and media management. Work in document sessions to pull content into an editing session, make precise line-based edits or larger replacements, and then push changes back to WordPress in a single update.

How to install

Prerequisites for running the MCP server include having Node.js and a functioning WordPress site with appropriate credentials. You will also need the WordPress Feature API plugin to enable semantic operations beyond the basic REST API.

Step-by-step commands you will run to set up locally:

# Clone the MCP server repository
git clone https://github.com/aaronsb/wordpress-mcp
cd wordpress-mcp

# Install dependencies
npm install

# Run the interactive setup (helps configure credentials and environment)
npm run setup

Configuration and operation details

The server relies on credentials and environment configuration to connect to your WordPress site. You should provide WordPress site URL, username, and an application password. You can store credentials globally or per-project using an .env file.

Security and permissions

WordPress always enforces its own permissions. The MCP server presents tools based on the chosen personality, but WordPress will deny actions outside the actual user permissions. For example, a Contributor trying to publish will receive a 403 from WordPress, and the MCP server will surface a helpful message. All edits and operations respect WordPress roles and capabilities.

Usage workflows and document editing

Use document sessions to pull content for editing, view or edit content in a structured way, and sync changes back to WordPress in one update. The system supports line-based editing for precise changes, context-aware search/replace, and automatic format conversion between Markdown and WordPress HTML.

Troubleshooting tips

If you encounter authentication errors, verify that your WordPress Application Password is correct and that the WordPress site URL matches the credential configuration. Ensure the WordPress Feature API plugin is active so semantic operations are available.

Available tools

draft-article

Create a draft post ready for drafting content before publishing

draft-page

Create a draft page to begin static content with hierarchy potential

edit-draft

Edit an existing draft post or page

submit-for-review

Submit a draft for editorial approval

view-editorial-feedback

View editor comments and feedback on drafts or published posts

pull-for-editing

Fetch posts or pages into an editing session using an opaque document handle

read-document

Read a pulled document with line numbers for precise editing

edit-document-line

Replace content at a specific line number within the editing session

insert-at-line

Insert content at a precise line position in the document session

replace-lines

Replace a range of lines in the document session

search-replace

Context-aware search and replace within a document session

edit-document

Fallback string replacement within the document session

sync-to-wordpress

Push all local edits back to WordPress in a single update action

list-editing-sessions

List active editing sessions for reference

close-editing-session

Manually end an editing session and cleanup resources

create-article

Create and publish a new post immediately (authorial publishing)

create-page

Create and publish a new page, with optional parent hierarchy

publish-workflow

Publish, schedule, or manage the publication workflow for content

manage-media

Upload and manage media assets in WordPress

trash-own-content

Move your own posts or pages to trash

bulk-content-operations

Perform bulk actions on multiple posts/pages (trash, restore, delete, change status)

manage-all-content

View and manage all posts and pages in the site

review-content

Review pending posts and comments for editorial process

moderate-comments

Approve or reject comments and manage moderation

manage-categories

Create, update, and organize categories