Skip to main content
Glama

WordPress MCP Server

License: MIT

MCP (Model Context Protocol) server for WordPress REST API. Manage posts, pages, media, comments, categories, tags, and users through 20 tools. Secure and optimized edition.

Works with Claude Desktop, Cursor, VS Code, and any MCP client.


IMPORTANT

💡 Activation Keywords

This MCP server is always active in the hub. Agents automatically invoke it based on context using these trigger keywords:

  • WordPress / blog / site / article / post ➔ triggers wp_list_posts, wp_get_post, wp_create_post, wp_update_post, wp_delete_post

  • page / landing page / parent ➔ triggers wp_list_pages, wp_create_page, wp_update_page, wp_delete_page

  • media / image / gallery / file ➔ triggers wp_list_media, wp_delete_media

  • comments / moderate / approve / spam ➔ triggers wp_list_comments, wp_create_comment, wp_update_comment, wp_delete_comment

  • category / tag / taxonomy ➔ triggers wp_list_categories, wp_list_tags

  • users / roles / site info / settings ➔ triggers wp_list_users, wp_get_site_info


Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@alexgenovese/wordpress-mcp"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-application-password"
      }
    }
  }
}

Cursor / VS Code

Add to MCP settings:

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@alexgenovese/wordpress-mcp"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-application-password"
      }
    }
  }
}

HTTP Mode (Streamable HTTP)

For remote deployment or shared access:

WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npx @alexgenovese/wordpress-mcp --http

Server starts on port 3000 (configurable via PORT env var). MCP endpoint: http://localhost:3000/mcp


Related MCP server: wp-mcp

Configuration

Environment Variable

Required

Description

WORDPRESS_URL

Yes

WordPress site URL (e.g. https://your-site.com)

WORDPRESS_USERNAME

Yes

WordPress username

WORDPRESS_APP_PASSWORD

Yes

Application Password (see below)

PORT

No

Port for HTTP server (default: 3000, only used with --http)

How to Create an Application Password

  1. Go to your WordPress Admin → Users → Profile

  2. Scroll down to Application Passwords

  3. Enter a name (e.g. "MCP Server") and click Add New Application Password

  4. Copy the generated password

Important: WordPress displays the password with spaces for readability (e.g. cUAn CKZ1 u5DN). The server automatically removes spaces — you can paste it as-is.


All Tools (20 tools)

Posts (5 tools)

Tool

Description

wp_list_posts

List posts with filters (status, search, per_page)

wp_get_post

Get single post with full content

wp_create_post

Create post (title, content, status, categories, tags)

wp_update_post

Update post fields

wp_delete_post

Delete post (moves to trash)

Pages (5 tools)

Tool

Description

wp_list_pages

List pages with status filter

wp_get_page

Get single page with full content

wp_create_page

Create page (title, content, status, parent)

wp_update_page

Update page fields

wp_delete_page

Delete page

Media (2 tools)

Tool

Description

wp_list_media

List media files with type filter

wp_delete_media

Permanently delete media file

Comments (4 tools)

Tool

Description

wp_list_comments

List comments, filter by post

wp_create_comment

Create comment on post

wp_update_comment

Moderate comment (approve/hold/spam/trash)

wp_delete_comment

Permanently delete comment

Taxonomy (2 tools)

Tool

Description

wp_list_categories

List all categories with post counts

wp_list_tags

List all tags with post counts

Users & Site (2 tools)

Tool

Description

wp_list_users

List users with roles

wp_get_site_info

Get site name, description, URL, timezone


Requirements

  • Node.js 18+

  • WordPress with REST API enabled (enabled by default)

  • Application Password (WordPress 5.6+)


For Developers

git clone https://github.com/alexgenovese/mcp-wordpress.git
cd mcp-wordpress
npm install
npm run build

# Run in stdio mode
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm start

# Run in dev mode (hot reload)
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm run dev

# Run in HTTP mode
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm start -- --http

License

MIT License - see LICENSE

Copyright (c) 2026 Alex Genovese

Available Tools

20 tools
wp_create_commentB

Create a new comment on a WordPress post.

Inputs: post (required), content (required), author_name, author_email.

wp_create_pageA

Create a new WordPress page. Provide title and content (HTML). Optionally set parent page for hierarchy.

Inputs: title (required), content (required), parent, status.

wp_create_postA

Create a new WordPress post. Provide title and content (HTML). Optionally set status (draft/publish), categories, and tags.

Inputs: title (required), content (required), tags, status, +1 more.

wp_delete_commentA
Destructive

Permanently delete a comment.

Inputs: id (required).

wp_delete_mediaA
Destructive

Permanently delete a media file from WordPress.

Inputs: id (required).

wp_delete_pageB
Destructive

Delete a WordPress page.

Inputs: id (required).

wp_delete_postA
Destructive

Delete a WordPress post. Moves to trash by default.

Inputs: id (required).

wp_get_pageA
Read-only

Get a single WordPress page with full content and metadata.

Inputs: id (required).

wp_get_postA
Read-only

Get a single WordPress post with full content, metadata, categories, and tags. Use to inspect post content before editing.

Inputs: id (required).

wp_get_site_infoA
Read-only

Get WordPress site information: name, description, URL, timezone, and available features.

Inputs: _fields.

wp_list_categoriesA
Read-only

List all WordPress categories with post counts.

Inputs: search, per_page.

wp_list_commentsA
Read-only

List comments on WordPress posts. Filter by post ID.

Inputs: post, per_page.

wp_list_mediaA
Read-only

List media files in the WordPress library. Returns file URLs, types, and metadata.

Inputs: per_page, media_type.

wp_list_pagesA
Read-only

List WordPress pages. Returns page ID, title, status, and parent page. Use to browse site page structure.

Inputs: status, per_page.

wp_list_postsA
Read-only

List WordPress posts with optional filters. Returns post ID, title, status, date, and categories. Use to browse existing content or find posts by keyword.

Inputs: search, status, per_page.

wp_list_tagsB
Read-only

List all WordPress tags with post counts.

Inputs: search, per_page.

wp_list_usersA
Read-only

List WordPress users with their roles.

Inputs: search, per_page.

wp_update_commentA
Idempotent

Update or moderate a comment. Change content or approval status.

Inputs: id (required), status, content.

wp_update_pageC
Idempotent

Update an existing WordPress page.

Inputs: id (required), title, status, content.

wp_update_postA
Idempotent

Update an existing WordPress post. Change title, content, status, categories, or tags.

Inputs: id (required), tags, title, status, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 20 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action (e.g., wp_get_page vs wp_list_pages, wp_create_post vs wp_create_comment). There is no ambiguity between tools that operate on different WordPress entities.

    Naming Consistency5/5

    All tools follow a strict wp_verb_noun pattern (get, list, create, update, delete) with clear resource names. The convention is consistent across the entire set, making the API highly predictable.

    Tool Count4/5

    20 tools is slightly heavier than the typical 3-15 range, but each tool corresponds to a specific WordPress operation across posts, pages, comments, media, and taxonomies. The count feels justified for the domain, though it borders on heavy.

    Completeness3/5

    Posts, pages, and comments have solid CRUD coverage, but media lacks upload/create and update capabilities, and categories/tags have only list operations. These are notable gaps for a WordPress management server, though core content workflows are supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server for managing WordPress sites through the REST API, featuring 38 tools for content, media, plugin, and theme management. It supports secure Application Password authentication and offers specific compatibility for Divi theme shortcode structures.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for WordPress content management via REST API, supporting posts, pages, media, comments, and terms through natural language interfaces like Cursor, ChatGPT, Codex, and Claude.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server for managing multiple WordPress sites via the WordPress REST API. It supports posts, categories, tags, media, comments, and site configuration through natural language.
      48 npm
      ISC