Leonelberio the wordpress mcp server

A Model Context Protocol (MCP) server for WordPress integration, compatible with Windows, macOS, and Linux.

This MCP server enables interaction with WordPress sites through the WordPress REST API. It provides tools for creating, retrieving, and updating posts using JSON-RPC 2.0 protocol.

1. Clone the repository
2. Install dependencies:

npm install

1. Build the project:

npm run build

Add the server to your MCP settings file with environment variables for WordPress credentials:

{
  "mcpServers": {
    "wordpress": {
      "command": "node",
      "args": ["path/to/build/index.js"],
      "env": {
        "WORDPRESS_SITE_URL": "https://your-wordpress-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_PASSWORD": "your-app-password"
      }
    }
  }
}

The environment variables are:

• WORDPRESS_SITE_URL: Your WordPress site URL
• WORDPRESS_USERNAME: WordPress username
• WORDPRESS_PASSWORD: WordPress application password

You can also provide these credentials in the request parameters if you prefer not to use environment variables.

Creates a new WordPress post.

Parameters:

• siteUrl: (optional if set in env) WordPress site URL
• username: (optional if set in env) WordPress username
• password: (optional if set in env) WordPress application password
• title: Post title
• content: Post content
• status: (optional) 'draft' | 'publish' | 'private' (default: 'draft')

Retrieves WordPress posts.

Parameters:

• siteUrl: (optional if set in env) WordPress site URL
• username: (optional if set in env) WordPress username
• password: (optional if set in env) WordPress application password
• perPage: (optional) Number of posts per page (default: 10)
• page: (optional) Page number (default: 1)

Updates an existing WordPress post.

Parameters:

• siteUrl: (optional if set in env) WordPress site URL
• username: (optional if set in env) WordPress username
• password: (optional if set in env) WordPress application password
• postId: ID of the post to update
• title: (optional) New post title
• content: (optional) New post content
• status: (optional) 'draft' | 'publish' | 'private'

For security, it's recommended to use WordPress application passwords instead of your main account password. You can generate an application password in your WordPress dashboard under Users → Security → Application Passwords.

Using environment variables:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "create_post",
  "params": {
    "title": "My New Post",
    "content": "Hello World!",
    "status": "draft"
  }
}

Without environment variables:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "create_post",
  "params": {
    "siteUrl": "https://your-wordpress-site.com",
    "username": "your-username",
    "password": "your-app-password",
    "title": "My New Post",
    "content": "Hello World!",
    "status": "draft"
  }
}

• Node.js 20.0.0 or higher
• WordPress site with REST API enabled
• WordPress application password for authentication

MIT License - See LICENSE file for details