wordpress-mcp
About
Lightweight WordPress MCP server with 42 tools. Token-optimized responses reduce REST API verbosity by 95%+. Posts, pages, users, plugins, themes, media, taxonomies, comments.
Details
- Author
- cvrt-jh
- Categories
- Productivity, Other
Jump to
Setup
Install wordpress-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/cvrt-jh/wordpress-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Lightweight WordPress MCP server for site management.158 toolswithtoken-optimized responses— REST API responses automatically slimmed from kilobytes to essentials.
v2.1: Now includes Pro modules for ACF and WooCommerce viawp-pilot-pro.
v2.0: Extended tools for thecvrt-mcp-endpointsplugin — install plugins/themes from WordPress.org, database management, full widget/menu control, and more.
WordPress REST API returns extremely verbose JSON (~5-10KB per post). This server strips it down:
Less tokens = faster responses, lower costs, more context for your AI.
npm install -g @cavort-it-systems/wordpress-mcp
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
Add to your MCP config (~/.claude.jsonor Claude Desktop settings):
{ "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" } } } }
git clone https://github.com/cvrt-jh/wordpress-mcp.git cd wordpress-mcp npm install && npm run build
UsesApplication Passwords(WordPress 5.6+):
- Go toUsers → Profilein WordPress admin
- Scroll toApplication Passwords
- Create new password for "Claude MCP"
- Use the generated password (keep the spaces)
All responses are automatically trimmed. Example:
// 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}
- 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
- 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
- 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
- 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
- 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
- wp_list_themes- List themes
- wp_get_active_theme- Get active theme
- wp_get_theme- Get theme details
- wp_activate_theme- Switch themes
- wp_list_media- List media library
- wp_get_media- Get media item
- wp_update_media- Update media metadata
- wp_delete_media- Delete media
- 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
- 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 thecvrt-mcp-endpointsWordPress plugin to be installed and activated.
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
Requireswp-pilot-proand Advanced Custom Fields.
- 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
- 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
- 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
- acf_list_options_pages- List options pages
- acf_get_options_fields- Get options page fields
- acf_update_options_fields- Update options fields
- 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
- 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
- acf_get_relationship- Get related posts
- acf_set_relationship- Set related posts
- acf_add_to_relationship- Add posts
- acf_remove_from_relationship- Remove posts
- acf_get_clone_references- Get clone field refs
- acf_get_field_object- Get field schema
WooCommerce Module (42 tools) — Requires wp-pilot-pro + WooCommerce
- 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
- woo_list_variations- List product variations
- woo_create_variation- Create variation
- woo_update_variation- Update variation
- woo_delete_variation- Delete variation
- woo_list_attributes- List attributes
- woo_list_attribute_terms- List attribute terms
- woo_create_attribute- Create attribute
- woo_create_attribute_term- Create term
- 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
- 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
- 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
- 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
- woo_sales_report- Sales report
- woo_top_sellers- Top selling products
- woo_stock_report- Stock status report
- woo_get_product_meta- Get product meta
- woo_update_product_meta- Update product meta
- woo_bulk_update_stock- Bulk stock update
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
For managing multiple WordPress sites, run separate MCP instances:
{ "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" } } } }
A comprehensive MCP server for managing WordPress sites, featuring a wide range of tools for performance monitoring, caching, and more.
An MCP server for WordPress plugin audits
A free WordPress plugin that turns your site into a governed MCP server: 153 abilities that are all off until you switch them on, bound to a least-privilege WordPress user, with every call audited.
Connects Claude to WordPress sites to create posts and manage sites using the WordPress REST API.
Works the tickets of the self hosted Simple Support System helpdesk for Concrete CMS: read a ticket with its comments, reply, change its state, manage attachments.
A personality-based MCP server for WordPress, providing role-appropriate tools for content management.
A Model Context Protocol (MCP) server that gives AI agents full control over WordPress sites. 46 tools for posts, pages, media, SEO, comments, redirects, blocks, patterns, TablePress, and more.
Manage WordPress sites and create content with AI-generated featured images.
Manage WordPress sites via the REST API. Enables AI assistants to handle content, posts, and site configurations.
A secure bridge between AI assistants and WordPress, enabling site management and content operations through natural language.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
