WordPress MCP Server

A MCP server that connects WordPress sites to AI agents. Enable Claude Desktop, Cursor, VS Code, and other MCP-compatible AI clients to manage your WordPress content through natural language commands.

✨ Features

• 🔗 Direct WordPress Integration - Connect to any WordPress site via REST API
• 🛠 Comprehensive Content Management - Create, read, update, and delete posts, pages, taxonomies, users and media
• 🔒 Secure Authentication - Uses WordPress Application Passwords

🎥 Demo

demo.mov

🚀 Installation

npm install @adi.lib/wp-mcp

Requirements

• Node.js v18 or higher
• WordPress site with REST API enabled
• WordPress Application Password

🔧 Configuration

Environment Variables

Variable	Description	Example
WP_BASE_URL	WordPress site URL	https://mysite.com
WP_USERNAME	WordPress username	admin
WP_APP_PASSWORD	Application password	abc1 def2 ghi3 jkl4

Setup WordPress Application Password

1. Go to your WordPress Admin Dashboard
2. Navigate to Users → Your Profile
3. Scroll down to Application Passwords
4. Enter a name for your application (e.g., "MCP Server")
5. Click Add New Application Password
6. Copy the generated password and use it as WP_APP_PASSWORD

Adding MCP config to your client:

{
  "servers": {
    "wp-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@adi.lib/wp-mcp"],
      "env": {
        "WP_BASE_URL": "https://your-site.com",
        "WP_USERNAME": "admin",
        "WP_APP_PASSWORD": "abc1 def2 ghi3 jkl4"
      }
    }
  }
}

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Add your improvements
4. Test thoroughly with a WordPress site
5. Submit a pull request

📝 License

MIT License

---