https://github.com/mvtandas/wp-cli-mcp
MCP server that gives AI tools full WordPress management via WP-CLI — 30+ tools for themes, plugins, posts, menus, users, database, and scaffolding
https://github.com/mvtandas/wp-cli-mcp
ai claude-code cursor gutenberg mcp model-context-protocol php woocommerce wordpress wp-cli
Last synced: 12 days ago
JSON representation
MCP server that gives AI tools full WordPress management via WP-CLI — 30+ tools for themes, plugins, posts, menus, users, database, and scaffolding
- Host: GitHub
- URL: https://github.com/mvtandas/wp-cli-mcp
- Owner: mvtandas
- License: mit
- Created: 2026-04-14T12:41:01.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-14T14:30:46.000Z (2 months ago)
- Last Synced: 2026-04-14T16:09:31.843Z (2 months ago)
- Topics: ai, claude-code, cursor, gutenberg, mcp, model-context-protocol, php, woocommerce, wordpress, wp-cli
- Language: JavaScript
- Size: 29.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-devops-mcp-servers - mvtandas/wp-cli-mcp - WordPress management MCP server built on WP-CLI for themes, plugins, posts, menus, users, database operations, and scaffolding. (Project & Service Management / 🌐 CMS & Web Platforms)
README
# wp-cli-mcp
MCP server that gives AI tools full WordPress management via WP-CLI.
Themes, plugins, posts, menus, users, database, scaffolding — 45+ tools.
---
## What can Claude do with this?
```
"Install WooCommerce and activate it"
"Create a new page called About Us with this content..."
"List all plugins and deactivate the ones I'm not using"
"Scaffold a new child theme called my-theme"
"Create a navigation menu with Home, About, Contact links"
"Search and replace old domain with new domain in database"
"Export the database before I make changes"
"Generate a custom Gutenberg block for testimonials"
```
All powered by WP-CLI under the hood. Works locally or over SSH to remote servers.
## Tools (30+)
| Category | Tools |
|----------|-------|
| **Core** | `wp_core_version`, `wp_core_check_update` |
| **Plugins** | `wp_plugin_list`, `wp_plugin_install`, `wp_plugin_activate`, `wp_plugin_deactivate`, `wp_plugin_delete`, `wp_plugin_search` |
| **Themes** | `wp_theme_list`, `wp_theme_install`, `wp_theme_activate`, `wp_theme_delete` |
| **Theme Files** | `wp_theme_file_list`, `wp_theme_file_read`, `wp_theme_file_write`, `wp_theme_file_delete` |
| **Posts** | `wp_post_list`, `wp_post_get`, `wp_post_create`, `wp_post_update`, `wp_post_delete` |
| **Post Meta** | `wp_post_meta_get`, `wp_post_meta_update`, `wp_post_meta_list` |
| **Taxonomies** | `wp_term_list`, `wp_term_create` |
| **Users** | `wp_user_list`, `wp_user_create` |
| **Options** | `wp_option_get`, `wp_option_update` |
| **Menus** | `wp_menu_list`, `wp_menu_create`, `wp_menu_item_add`, `wp_menu_location_assign` |
| **Widgets** | `wp_sidebar_list`, `wp_widget_list` |
| **Media** | `wp_media_import` |
| **Database** | `wp_db_query`, `wp_db_export`, `wp_search_replace` |
| **Scaffold** | `wp_scaffold_theme`, `wp_scaffold_plugin`, `wp_scaffold_block` |
| **Cache** | `wp_rewrite_flush`, `wp_cache_flush` |
| **PHP** | `wp_eval` — execute any PHP in WordPress context |
| **Site** | `wp_site_info` — full site overview |
| **Raw** | `wp_cli_raw` — run any WP-CLI command |
## Requirements
- [WP-CLI](https://wp-cli.org/) installed and in PATH
- WordPress installation (local or accessible via SSH)
- Node.js 18+
## Setup
### Install
```bash
npm install -g wp-cli-mcp
```
### Configure with Claude Code
Add to your Claude Code MCP settings (`~/.claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"wordpress": {
"command": "wp-cli-mcp",
"env": {
"WP_PATH": "/path/to/your/wordpress"
}
}
}
}
```
### Remote server via SSH
```json
{
"mcpServers": {
"wordpress": {
"command": "wp-cli-mcp",
"env": {
"WP_SSH": "user@yourserver.com:/var/www/html"
}
}
}
}
```
### Environment Variables
| Variable | Description | Example |
|----------|-------------|---------|
| `WP_PATH` | Local WordPress path | `/var/www/html` |
| `WP_SSH` | SSH connection string | `user@host:/path/to/wp` |
| `WP_URL` | Site URL (multisite) | `https://example.com` |
## Examples
### Theme Development Workflow
```
You: "Scaffold a child theme based on twentytwentyfour"
Claude: Uses wp_scaffold_theme → creates child theme files
You: "Install and activate it"
Claude: Uses wp_theme_activate → theme is live
You: "Create the homepage with a hero section and 3 feature cards"
Claude: Uses wp_post_create → creates page with HTML content
```
### Plugin Management
```
You: "What plugins do I have installed?"
Claude: Uses wp_plugin_list → shows all plugins with status
You: "Install Contact Form 7 and WooCommerce"
Claude: Uses wp_plugin_install twice → both installed and activated
```
### Database Operations
```
You: "I'm migrating from staging.example.com to example.com"
Claude: Uses wp_db_export → backup first
Uses wp_search_replace (dry_run) → preview changes
Uses wp_search_replace → apply changes
Uses wp_cache_flush → clear cache
```
## Pairs well with
- **[Elementor MCP](https://github.com/msrbuilds/elementor-mcp)** — 97 tools for Elementor page building
- **[WordPress MCP](https://github.com/Automattic/wordpress-mcp)** — Official Automattic REST API tools
- **[wordpress-claude-stack](https://github.com/mvtandas/wordpress-claude-stack)** — CLAUDE.md + Cursor rules for WordPress
Use all three together for complete AI-powered WordPress development.
## License
MIT — [Mustafa Vatandas](https://github.com/mvtandas)