WordPress

This MCP server lets you control a WordPress site from an AI assistant by using the WordPress REST API. You can manage posts, users, comments, categories, tags, and custom endpoints from your app, enabling automated content workflows, site administration, and data retrieval in a secure, programmatic way.

How to use

You connect your WordPress MCP server to your MCP client and then issue high-level actions such as creating posts, updating user details, or retrieving comments. Each tool maps to a WordPress REST API operation, so you can perform common site management tasks without leaving your chat or automation flow. Use the client to choose an action, provide the required site URL and credentials, and specify the input data (for example, post title and content). The server handles authentication, parameter validation, and calls to WordPress, returning results or errors in a consistent format. You can paginate lists (posts, comments, users) and filter by identifiers like post IDs, category slugs, or user logins to refine your queries.

How to install

# Prerequisites: Node.js v18 or higher and a WordPress site with REST API enabled
# 1. Clone this MCP server repository
git clone [repository-url]
cd wordpress-mcp-server

# 2. Install dependencies
npm install

# 3. Build the server
npm run build

Configuration and setup after installation

Before you can use the server, you need to set up WordPress access and the MCP server runtime. Ensure REST API access is enabled on your WordPress site and create an application password for authentication.

Then configure the MCP to load the WordPress MCP server so your MCP client can discover and connect to it. The configuration below shows how to register the server as an MCP endpoint. Use the exact command and path shown to start the local server process.

MCP configuration

Add the WordPress MCP server to your MCP settings so your client can discover and use it. The example below runs the server as a local process via Node and points to the built entry script.

{
  "mcpServers": {
    "wordpress": {
      "command": "node",
      "args": ["path/to/wordpress-mcp-server/build/index.js"]
    }
  }
}

Security considerations

Always use HTTPS URLs when connecting to your WordPress site and prefer WordPress application passwords over your main password. Rotate credentials regularly and limit access using WordPress roles and capabilities.

Development and debugging

If you are contributing or testing, run in development mode to enable automatic recompilation and a smoother workflow.

npm run dev

Notes on usage and capabilities

The server exposes tools to manage posts, users, comments, and taxonomies, and also supports custom REST API endpoints. You can create, read, update, and delete resources, as well as perform filtered queries and pagination where supported by the WordPress API.

Available tools

create_post

Creates a new WordPress post with a title, content, and optional status (draft, publish, or private).

get_posts

Retrieves posts with support for pagination and additional query parameters.

update_post

Updates an existing WordPress post by ID with new title, content, or status.

delete_post

Deletes a WordPress post by ID.

get_users

Retrieves WordPress users with optional pagination.

get_user

Retrieves a specific WordPress user by ID.

get_user_by_login

Retrieves a WordPress user by login name.

get_comments

Retrieves comments with optional pagination and filtering by post.

create_comment

Creates a new comment on a post.

get_categories

Retrieves WordPress categories with pagination.

create_category

Creates a new WordPress category with optional metadata.

custom_request

Makes a custom request to any WordPress REST API endpoint with a chosen HTTP method.