io.github.cvrt-jh/wordpress-mcp
Lightweight WordPress MCP server - 42 tools, token-optimized (95% smaller responses)
Open source Open in the app JSON README (API)
About
Lightweight WordPress MCP server - 42 tools, token-optimized (95% smaller responses)
Details
- Kind
- MCP servers
- Topic
- Social & content
- Publisher
- cvrt-jh
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Stars
- 2
- Last push
- 2026-03-27T08:44:47Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:38
- Updated
- 2026-08-29 03:02:38
- Origin id
io.github.cvrt-jh/wordpress-mcp
README
# wordpress-mcp
[](https://www.npmjs.com/package/@cavort-it-systems/wordpress-mcp)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
Lightweight WordPress MCP server for site management. **158 tools** with **token-optimized responses** — REST API responses automatically slimmed from kilobytes to essentials.
**v2.1**: Now includes Pro modules for ACF and WooCommerce via [wp-pilot-pro](https://github.com/cvrt-gmbh/wp-pilot-pro).
**v2.0**: Extended tools for the [cvrt-mcp-endpoints](https://github.com/cvrt-gmbh/cvrt-mcp-endpoints) plugin — install plugins/themes from WordPress.org, database management, full widget/menu control, and more.
## Why This Server?
WordPress REST API returns extremely verbose JSON (~5-10KB per post). This server strips it down:
| Response | Before | After | Reduction |
|----------|--------|-------|-----------|
| `wp_list_posts` (10 posts) | ~50KB | ~2KB | **96%** |
| `wp_get_post` | ~5KB | ~200 bytes | **96%** |
| `wp_list_plugins` | ~15KB | ~800 bytes | **95%** |
Less tokens = faster responses, lower costs, more context for your AI.
## Installation
```bash
npm install -g @cavort-it-systems/wordpress-mcp
```
Or run directly:
```bash
npx @cavort-it-systems/wordpress-mcp
```
## Configuration
### Claude Code CLI
```bash
claude mcp add wordpress \
-e WORDPRESS_SITE_URL=https://example.com \
-e WORDPRESS_USERNAME=admin \
-e WORDPRESS_PASSWORD="xxxx xxxx xxxx xxxx" \
-- npx @cavort-it-systems/wordpress-mcp
```
### Claude Desktop / Manual
Add to your MCP config (`~/.claude.json` or Claude Desktop settings):
```json
{
"mcpServers": {
"wordpress": {
"command": "npx",
"args": ["@cavort-it-systems/wordpress-mcp"],
"env": {
"WORDPRESS_SITE_URL": "https://example.com",
"WORDPRESS_USERNAME": "admin",
"WORDPRESS_PASSWORD": "xxxx xxxx xxxx xxxx"
}
}
}
}
```
### From Source
```bash
git clone https://github.com/cvrt-jh/wordpress-mcp.git
cd wordpress-mcp
npm install && npm run build
```
## Authentication
Uses **Application Passwords** (WordPress 5.6+):
1. Go to **Users → Profile** in WordPress admin
2. Scroll to **Application Passwords**
3. Create new password for "Claude MCP"
4. Use the generated password (keep the spaces)
## Response Slimming
All responses are automatically trimmed. Example:
**`wp_get_post`** — from ~5KB to ~200 bytes:
```json
// Before (WordPress REST API raw)
{"id":123,"date":"2026-01-15T10:30:00","date_gmt":"2026-01-15T09:30:00",
"guid":{"rendered":"https://example.com/?p=123"},"modified":"2026-01-20T14:00:00",
"modified_gmt":"2026-01-20T13:00:00","slug":"my-post","status":"publish",
"type":"post","link":"https://example.com/my-post/","title":{"rendered":"My Post"},
"content":{"rendered":"<p>Full content...</p>","protected":false},
"excerpt":{"rendered":"<p>Excerpt...</p>","protected":false},
"author":1,"featured_media":456,"comment_status":"open","ping_status":"open",
"sticky":false,"template":"","format":"standard","meta":{"footnotes":""},
"categories":[1,5],"tags":[10,20],"class_list":["post-123","type-post",...],
"_links":{"self":[...],"collection":[...],"about":[...],...}}
// After (slimmed)
{"id":123,"title":"My Post","slug":"my-post","status":"publish",
"date":"2026-01-15T10:30:00","modified":"2026-01-20T14:00:00",
"link":"https://example.com/my-post/","excerpt":"Excerpt...",
"author":1,"categories":[1,5],"tags":[10,20],"featured_media":456}
```
**What gets stripped:**
| Field | Where | Why |
|-------|-------|-----|
| `guid`, `_links` | everywhere | Internal WordPress data |
| `content.rendered` | lists | Only included when explicitly requested |
| `meta`, `class_list` | posts/pages | Theme/plugin metadata |
| `ping_status`, `comment_status` | posts | Rarely needed |
| `template`, `format`, `sticky` | posts | Theme-specific |
| HTML tags | excerpts | Clean text output |
| Pretty-print JSON | all | Compact single-line output |
## Tools (158)
### Standard WordPress REST API (42 tools)
These work with any WordPress site:
### Site (4)
- `wp_site_info` - Get site name, description, URL
- `wp_get_settings` - Get site settings
- `wp_update_settings` - Update site settings
- `wp_get_namespaces` - List REST API namespaces
### Posts (6)
- `wp_list_posts` - List posts with filters
- `wp_get_post` - Get single post
- `wp_create_post` - Create post
- `wp_update_post` - Update post
- `wp_delete_post` - Delete post
- `wp_search_posts` - Search posts
### Pages (5)
- `wp_list_pages` - List pages
- `wp_get_page` - Get single page
- `wp_create_page` - Create page
- `wp_update_page` - Update page
- `wp_delete_page` - Delete page
### Users (6)
- `wp_list_users` - List users
- `wp_me` - Get current user
- `wp_get_user` - Get user by ID
- `wp_create_user` - Create user
- `wp_update_user` - Update user
- `wp_delete_user` - Delete user
### Plugins (5)
- `wp_list_plugins` - List plugins
- `wp_get_plugin` - Get plugin details
- `wp_activate_plugin` - Activate plugin
- `wp_deactivate_plugin` - Deactivate plugin
- `wp_delete_plugin` - Delete plugin
### Themes (4)
- `wp_list_themes` - List themes
- `wp_get_active_theme` - Get active theme
- `wp_get_theme` - Get theme details
- `wp_activate_theme` - Switch themes
### Media (4)
- `wp_list_media` - List media library
- `wp_get_media` - Get media item
- `wp_update_media` - Update media metadata
- `wp_delete_media` - Delete media
### Categories & Tags (8)
- `wp_list_categories` - List categories
- `wp_create_category` - Create category
- `wp_update_category` - Update category
- `wp_delete_category` - Delete category
- `wp_list_tags` - List tags
- `wp_create_tag` - Create tag
- `wp_update_tag` - Update tag
- `wp_delete_tag` - Delete tag
### Comments (6)
- `wp_list_comments` - List comments
- `wp_get_comment` - Get comment
- `wp_create_comment` - Create comment
- `wp_update_comment` - Update/moderate comment
- `wp_delete_comment` - Delete comment
- `wp_moderate_comments` - Batch moderate
---
### Extended Tools (43 tools) — Requires cvrt-mcp-endpoints plugin
These require the [cvrt-mcp-endpoints](https://github.com/cvrt-gmbh/cvrt-mcp-endpoints) WordPress plugin to be installed and activated.
### Plugin Management (4)
- `mcp_search_plugins` - Search WordPress.org plugins
- `mcp_install_plugin` - Install plugin from WordPress.org
- `mcp_update_plugin` - Update single plugin
- `mcp_update_all_plugins` - Update all plugins
### Theme Management (5)
- `mcp_search_themes` - Search WordPress.org themes
- `mcp_install_theme` - Install theme from WordPress.org
- `mcp_update_theme` - Update single theme
- `mcp_update_all_themes` - Update all themes
- `mcp_delete_theme` - Delete inactive theme
### Core Management (6)
- `mcp_get_version` - Get WordPress version info
- `mcp_get_system_info` - Get comprehensive system info
- `mcp_check_updates` - Check for all updates
- `mcp_update_core` - Update WordPress core
- `mcp_flush_rewrite` - Flush rewrite rules
- `mcp_flush_cache` - Clear all caches
### Database Management (5)
- `mcp_get_tables` - List tables with sizes
- `mcp_search_replace` - Search/replace in database
- `mcp_optimize_tables` - Optimize all tables
- `mcp_clean_revisions` - Delete old revisions
- `mcp_clean_comments` - Delete spam/trash comments
### Options Management (5)
- `mcp_list_options` - List options with prefix filter
- `mcp_get_option` - Get single option
- `mcp_set_option` - Create/update option
- `mcp_delete_option` - Delete option
- `mcp_bulk_get_options` - Get multiple options
### Menu Management (8)
- `mcp_list_menus` - List navigation menus
- `mcp_get_menu_locations` - Get theme locations
- `mcp_get_menu` - Get menu with items
- `mcp_create_menu` - Create menu
- `mcp_delete_menu` - Delete menu
- `mcp_add_menu_item` - Add menu item
- `mcp_delete_menu_item` - Delete menu item
- `mcp_assign_menu_location` - Assign menu to location
### Widget Management (8)
- `mcp_list_sidebars` - List all sidebars
- `mcp_get_sidebar_widgets` - Get sidebar widgets
- `mcp_list_widget_types` - List widget types
- `mcp_get_widget` - Get widget details
- `mcp_add_widget` - Add widget to sidebar
- `mcp_update_widget` - Update widget settings
- `mcp_delete_widget` - Remove widget
- `mcp_move_widget` - Move widget to sidebar
### Health & Diagnostics (6)
- `mcp_get_health` - Site health score
- `mcp_get_debug_info` - Debug information
- `mcp_get_php_info` - PHP configuration
- `mcp_get_plugins_health` - Plugin health/updates
- `mcp_get_cron_status` - Cron jobs status
- `mcp_run_cron` - Run cron hook manually
---
### ACF Module (31 tools) — Requires wp-pilot-pro + ACF
Requires [wp-pilot-pro](https://github.com/cvrt-gmbh/wp-pilot-pro) and Advanced Custom Fields.
### Field Groups (4)
- `acf_list_field_groups` - List all field groups
- `acf_get_field_group` - Get field group with schema
- `acf_export_field_groups` - Export as JSON
- `acf_import_field_groups` - Import from JSON
### Post Fields (4)
- `acf_get_post_fields` - Get all fields for post
- `acf_update_post_fields` - Update multiple fields
- `acf_get_post_field` - Get single field value
- `acf_update_post_field` - Update single field
### Term & User Fields (4)
- `acf_get_term_fields` - Get term ACF fields
- `acf_update_term_fields` - Update term fields
- `acf_get_user_fields` - Get user ACF fields
- `acf_update_user_fields` - Update user fields
### Options Pages (3)
- `acf_list_options_pages` - List options pages
- `acf_get_options_fields` - Get options page fields
- `acf_update_options_fields` - Update options fields
### Repeater Fields (5)
- `acf_get_repeater` - Get repeater rows
- `acf_add_repeater_row` - Add row
- `acf_update_repeater_row` - Update row
- `acf_delete_repeater_row` - Delete row
- `acf_reorder_repeater` - Reorder rows
### Flexible Content (5)
- `acf_get_flexible` - Get layouts
- `acf_add_flexible_layout` - Add layout
- `acf_update_flexible_layout` - Update layout
- `acf_delete_flexible_layout` - Delete layout
- `acf_reorder_flexible` - Reorder layouts
### Relationship Fields (4)
- `acf_get_relationship` - Get related posts
- `acf_set_relationship` - Set related posts
- `acf_add_to_relationship` - Add posts
- `acf_remove_from_relationship` - Remove posts
### Utility (2)
- `acf_get_clone_references` - Get clone field refs
- `acf_get_field_object` - Get field schema
---
### WooCommerce Module (42 tools) — Requires wp-pilot-pro + WooCommerce
Requires [wp-pilot-pro](https://github.com/cvrt-gmbh/wp-pilot-pro) and WooCommerce.
### Products (5)
- `woo_list_products` - List products with filters
- `woo_get_product` - Get product details
- `woo_create_product` - Create product
- `woo_update_product` - Update product
- `woo_delete_product` - Delete product
### Variations (4)
- `woo_list_variations` - List product variations
- `woo_create_variation` - Create variation
- `woo_update_variation` - Update variation
- `woo_delete_variation` - Delete variation
### Attributes (4)
- `woo_list_attributes` - List attributes
- `woo_list_attribute_terms` - List attribute terms
- `woo_create_attribute` - Create attribute
- `woo_create_attribute_term` - Create term
### Categories & Tags (5)
- `woo_list_categories` - List product categories
- `woo_create_category` - Create category
- `woo_update_category` - Update category
- `woo_delete_category` - Delete category
- `woo_list_tags` - List product tags
### Orders (5)
- `woo_list_orders` - List orders
- `woo_get_order` - Get order details
- `woo_update_order_status` - Update status
- `woo_add_order_note` - Add note
- `woo_get_order_notes` - Get notes
### Customers (5)
- `woo_list_customers` - List customers
- `woo_get_customer` - Get customer
- `woo_create_customer` - Create customer
- `woo_update_customer` - Update customer
- `woo_get_customer_orders` - Get order history
### Coupons (5)
- `woo_list_coupons` - List coupons
- `woo_get_coupon` - Get coupon
- `woo_create_coupon` - Create coupon
- `woo_update_coupon` - Update coupon
- `woo_delete_coupon` - Delete coupon
### Reports (3)
- `woo_sales_report` - Sales report
- `woo_top_sellers` - Top selling products
- `woo_stock_report` - Stock status report
### Product Meta & Inventory (3)
- `woo_get_product_meta` - Get product meta
- `woo_update_product_meta` - Update product meta
- `woo_bulk_update_stock` - Bulk stock update
## Architecture
```
src/
index.ts # Entry: McpServer + StdioServerTransport
client.ts # WordPress REST API client (Basic Auth)
types.ts # Shared Zod schemas + jsonResult helper
slim.ts # Response slimming transformers
tools/
# Standard WP REST API (wp/v2)
site.ts # 4 tools
posts.ts # 6 tools
pages.ts # 5 tools
users.ts # 6 tools
plugins.ts # 5 tools
themes.ts # 4 tools
media.ts # 4 tools
taxonomies.ts # 8 tools (categories + tags)
comments.ts # 6 tools
# Extended (mcp/v1) - requires cvrt-mcp-endpoints plugin
mcp-plugins.ts # 4 tools - install from WordPress.org
mcp-themes.ts # 5 tools - install from WordPress.org
mcp-core.ts # 6 tools - updates, cache flush
mcp-database.ts # 5 tools - search-replace, optimize
mcp-options.ts # 5 tools - full options CRUD
mcp-menus.ts # 8 tools - navigation menus
mcp-widgets.ts # 8 tools - sidebar widgets
mcp-health.ts # 6 tools - diagnostics, cron
# Pro modules (mcp/v1) - requires wp-pilot-pro
mcp-acf.ts # 31 tools - ACF integration
mcp-woo.ts # 42 tools - WooCommerce
```
## Multi-Site Support
For managing multiple WordPress sites, run separate MCP instances:
```json
{
"mcpServers": {
"wordpress-site1": {
"command": "npx",
"args": ["@cavort-it-systems/wordpress-mcp"],
"env": {
"WORDPRESS_SITE_URL": "https://site1.com",
"WORDPRESS_USERNAME": "admin",
"WORDPRESS_PASSWORD": "xxxx xxxx xxxx xxxx"
}
},
"wordpress-site2": {
"command": "npx",
"args": ["@cavort-it-systems/wordpress-mcp"],
"env": {
"WORDPRESS_SITE_URL": "https://site2.com",
"WORDPRESS_USERNAME": "admin",
"WORDPRESS_PASSWORD": "yyyy yyyy yyyy yyyy"
}
}
}
}
```
## License
MIT