Claudeus WordPress MCP

"The Most Comprehensive WordPress MCP Server - 145 Tools, Zero Compromise!"🖤

145 Production-Ready Toolscovering every aspect of WordPress management, from content creation to site health monitoring, all powered by AI and built with enterprise-grade quality.

╔═══════════════════════════════════════════════════════╗ ║ 🎯 COMPLETE WORDPRESS COVERAGE 🎯 ║ ╚═══════════════════════════════════════════════════════╝ ✅ Content Management 25 tools ✅ Media & Assets 6 tools ✅ Taxonomies 12 tools ✅ User Management 10 tools ✅ Comments & Moderation 8 tools ✅ Menus & Navigation 10 tools ✅ Full Site Editing (FSE) 27 tools ✅ Astra Pro Integration 11 tools ✅ Site Configuration 15 tools ✅ Site Health & Diagnostics 8 tools ✅ Search & Discovery 5 tools ✅ WooCommerce 3 tools ✅ System Discovery 5 tools 📊 TOTAL: 145 PRODUCTION-READY TOOLS

- Content Mastery: Full CRUD for Posts, Pages, Blocks with revisions & autosaves
- FSE Powerhouse: Templates, Global Styles, Block Patterns, Navigation
- Theme Control: Astra Pro integration (Mega Menus, Custom Layouts, Settings)
- User & Access: Complete user management with application passwords
- E-Commerce: WooCommerce product, order, and sales management
- Site Health: Comprehensive diagnostics and monitoring
- Universal Search: AI-powered content discovery across all types

- Type-Safe: 100% TypeScript with strict mode
- Modular Design: 20+ specialized modules for maintainability
- Security First: Input validation, output sanitization, authentication
- Performance: Pagination, caching, batch operations
- Zero Errors: Production-ready with comprehensive testing

- Claude Desktop Integration: First-class MCP protocol support
- AI-Powered Workflows: Intelligent content generation & optimization
- Batch Operations: Automate hundreds of tasks simultaneously
- Context-Aware: AI understands your WordPress structure

- Read:get_posts,get_post,get_pages,get_page,get_blocks,get_block
- Create:create_post,create_page,create_block
- Update:update_post,update_page,update_block
- Delete:delete_post,delete_page,delete_block

- Post Revisions: List, get, delete revisions
- Page Revisions: List, get, delete revisions
- Block Revisions: List, get, delete revisions
- Autosaves: Get/create autosaves for posts, pages, blocks

- get_media- List media library
- get_media_item- Get specific media
- upload_media- Upload files
- update_media- Update metadata
- delete_media- Remove files
- update_alt_text- SEO optimization

- get_categories,get_category,create_category,update_category,delete_category

- get_tags,get_tag,create_tag,update_tag,delete_tag

- get_users,get_user,get_me
- create_user,update_user,delete_user
- create_app_password,list_app_passwords
- revoke_app_password,introspect_password
- get_comments,get_comment
- create_comment,update_comment,delete_comment
- approve,spam,trash(moderation actions)

- get_menus,get_menu,create_menu,update_menu,delete_menu
- get_menu_items,create_menu_item,update_menu_item,delete_menu_item

Templates & Template Parts (10 tools)

- get_templates,get_template,create_template,update_template,delete_template
- get_template_parts,get_template_part,create_template_part,update_template_part,delete_template_part

- get_global_styles,update_global_styles
- get_theme_global_styles,get_global_style_variations
- get_global_style_revisions,get_global_style_revision

- get_local_patterns,get_pattern_categories,search_pattern_directory

- get_mega_menu,update_mega_menu
- enable_mega_menu,disable_mega_menu

Custom Layouts & Advanced Hooks (5 tools)

- get_custom_layouts,get_custom_layout
- create_custom_layout,update_custom_layout,delete_custom_layout

- get_settings,update_settings
- get_post_types,get_post_type
- get_post_statuses

- list,get,activate,deactivate,delete

- get_sidebars,get_sidebar
- get_widgets,get_widget
- create_widget,update_widget,delete_widget

- list_themes,get_custom_css,update_custom_css

10. Site Health & Diagnostics (8 tools)

- test_auth- Authorization header test
- test_background_updates- Background updates check
- test_dotorg_communication- WordPress.org connectivity
- test_https- HTTPS validation
- test_loopback- Loopback requests test
- test_page_cache- Page cache validation
- get_directory_sizes- Storage monitoring
- run_all_tests- Comprehensive health report

- search- Universal content search
- oembed- Rich embed data retrieval
- oembed_proxy- External oEmbed proxy
- get_url_details- URL metadata for blocks
- block_directory- WordPress.org block search

- get_products- Product catalog
- get_orders- Order management
- get_sales- Sales analytics

- discover_endpoints- List all available endpoints
- Theme, plugin, and capability discovery

Node.js ≥ 22.0.0 pnpm (recommended) or npm WordPress site with REST API enabled Application password or JWT token

# Install globally npm install -g claudeus-wp-mcp # Or use directly with npx npx claudeus-wp-mcp

# Clone repository git clone https://github.com/deus-h/claudeus-wp-mcp cd claudeus-wp-mcp # Install dependencies pnpm install # Build pnpm build # Test with Inspector UI pnpm inspector

Create awp-sites.jsonfile to configure your WordPress sites:

{ "default_test": { "URL": "https://your-site.com", "USER": "admin", "PASS": "your-application-password", "authType": "basic" }, "production": { "URL": "https://production-site.com", "USER": "admin", "PASS": "prod-app-password", "authType": "basic" } }

- Log into WordPress Admin
- Go toUsers → Profile
- Scroll toApplication Passwords
- Enter a name (e.g., "Claude MCP")
- ClickAdd New
- Copy the generated password (format:xxxx xxxx xxxx xxxx xxxx xxxx)

Add to your Claude Desktop configuration:

- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "claudeus-wp-mcp": { "command": "npx", "args": ["-y", "claudeus-wp-mcp"], "env": { "WP_SITES_PATH": "/absolute/path/to/your/wp-sites.json" } } } }

- Restart Claude Desktop completely
- Look for the🔨 hammer iconin the input box
- Click it to see all 145 WordPress tools
- Start automating! 🤘

The Inspector UI lets you test and explore all tools visually:

# Launch Inspector pnpm inspector # Opens browser at http://localhost:5173

- 🔍Explore Tools: Browse all 145 tools with descriptions
- ⚡Test Endpoints: Try tools with sample data
- 📊View Responses: See real API responses
- 🐛Debug: Monitor server communication
- 📝Test Prompts: Try AI-powered workflows

src/ ├── api/ # 17 specialized API clients │ ├── posts.ts # Posts API │ ├── taxonomies.ts # Taxonomies API │ ├── users.ts # Users API │ ├── health.ts # Site Health API │ └── ... # And 13 more! │ ├── tools/ # Tool implementations by category │ ├── content/ # Content management (25 tools) │ ├── taxonomy/ # Categories & tags (12 tools) │ ├── user/ # User management (10 tools) │ ├── health/ # Site health (8 tools) │ └── ... # And 10 more modules! │ ├── types/ # TypeScript definitions │ ├── post.ts # Post types │ ├── taxonomy.ts # Taxonomy types │ ├── health.ts # Health types │ └── ... # Complete type coverage │ ├── handlers/ # Request handlers │ ├── tools.ts # Tool routing │ ├── resources.ts # Resource handlers │ └── prompts.ts # Prompt handlers │ └── security/ # Security framework ├── validation/ # Input validation ├── sanitization/ # Output sanitization └── auth/ # Authentication

- ✅ Basic Auth (Application Passwords)
- ✅ JWT Token support
- ✅ Secure credential management

- ✅ Input sanitization
- ✅ Output escaping
- ✅ Schema validation
- ✅ Type checking

- ✅ SQL injection prevention
- ✅ XSS protection
- ✅ CSRF protection
- ✅ Rate limiting support

All list endpoints support pagination with metadata:

{ "data": [...], "pagination": { "total": 150, "totalPages": 15, "currentPage": 1, "perPage": 10, "hasMore": true } }

- Bulk content updates
- Mass media processing
- Multi-site operations

- Response caching
- Query optimization
- Efficient data fetching

- ✅ AI-powered blog post generation
- ✅ Bulk content updates
- ✅ SEO optimization
- ✅ Media management

- ✅ Headless CMS integration
- ✅ Custom theme development
- ✅ Plugin testing & debugging
- ✅ API automation

- ✅ Multi-site management
- ✅ User & access control
- ✅ Site health monitoring
- ✅ Performance optimization

- ✅ Client site management
- ✅ Deployment automation
- ✅ Content migration
- ✅ Maintenance workflows
- 🔒 Always Backup: Before bulk operations
- 🧪 Test First: Use staging environment
- 👀 Review Changes: Verify AI-generated content
- 🔐 Secure Credentials: Protect application passwords
- 📊 Monitor Usage: Track API calls and performance

# All tests pnpm test # Specific suites pnpm test:unit pnpm test:integration # With coverage pnpm test:coverage

- Setup Guide- Detailed installation & configuration
- Security Guide- Security best practices
- Contributing- Development guidelines
- Changelog- Version history and release notes

Want to join the team?Contact:deus.h@outlook.com

Manage WordPress posts and upload images directly from file paths.