Claudeus WordPress MCP Server

A server for integrating with WordPress sites, enabling content management and interaction via the Model Context Protocol.

GitHub

Documentation

🤘 Claudeus WordPress MCP 🎸

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

License Node GitHub Stars NPM Version MCP Standard

Claudeus WordPress MCP Server

🔥 The Complete WordPress AI Powerhouse

145 Production-Ready Tools covering 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

⚡ What Makes It Legendary?

🎸 Complete WordPress Ecosystem Coverage

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

💪 Enterprise-Grade Architecture

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

🚀 Built for AI

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

📊 Complete Tool Inventory

1. Content Management (25 tools)

Posts, Pages & Blocks

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

Revisions & Autosaves (18 tools)

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

2. Media & Assets (6 tools)

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

3. Taxonomies (12 tools)

Taxonomy Discovery

get_taxonomies, get_terms

4. User Management (10 tools)

get_users, get_user, get_me
create_user, update_user, delete_user
create_app_password, list_app_passwords
revoke_app_password, introspect_password

5. Comments & Moderation (8 tools)

get_comments, get_comment
create_comment, update_comment, delete_comment
approve, spam, trash (moderation actions)

6. Menus & Navigation (10 tools)

Classic Menus

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

Locations

get_locations

7. Full Site Editing - FSE (27 tools)

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

Global Styles (6 tools)

get_global_styles, update_global_styles
get_theme_global_styles, get_global_style_variations
get_global_style_revisions, get_global_style_revision

Block Patterns (3 tools)

get_local_patterns, get_pattern_categories, search_pattern_directory

Navigation Blocks (8 tools included in menus)

8. Astra Pro Integration (11 tools)

Mega Menus (4 tools)

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

Theme Settings (2 tools)

get_settings, update_settings

9. Site Configuration (15 tools)

Site Settings (5 tools)

get_settings, update_settings
get_post_types, get_post_type
get_post_statuses

Plugins (5 tools)

list, get, activate, deactivate, delete

Widgets & Sidebars (7 tools)

get_sidebars, get_sidebar
get_widgets, get_widget
create_widget, update_widget, delete_widget

Theme Management (2 tools)

list_themes, get_custom_css, update_custom_css

11. Search & Discovery (5 tools)

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

12. WooCommerce (3 tools)

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

13. System Discovery (5 tools)

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

🚀 Quick Start

Prerequisites

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

Installation

Via NPM (Recommended)

Install globally

npm install -g claudeus-wp-mcp

Or use directly with npx

npx claudeus-wp-mcp

For Development

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

⚙️ Configuration

1. Create wp-sites.json

Create a wp-sites.json file 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" } }

Getting Your Application Password

Log into WordPress Admin
Go to Users → Profile
Scroll to Application Passwords
Enter a name (e.g., "Claude MCP")
Click Add New
Copy the generated password (format: xxxx xxxx xxxx xxxx xxxx xxxx)

2. Configure Claude Desktop

Add to your Claude Desktop configuration:

File Location:

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

Configuration:

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

3. Restart Claude Desktop

After configuration:

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

🎸 Using the MCP Inspector

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

Launch Inspector

pnpm inspector

Opens browser at http://localhost:5173

Inspector Features:

🔍 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

💪 Architecture Highlights

Modular Design

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

Key Features

Feature	Implementation	Benefit
Type Safety	100% TypeScript, strict mode	Zero runtime type errors
Modularity	20+ independent modules	Easy maintenance & scaling
Security	Multi-layer validation	Enterprise-grade protection
Performance	Pagination, caching, batching	Handle large datasets
Error Handling	Comprehensive try-catch	Graceful failure recovery

🔒 Security Features

Authentication

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

Validation

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

Protection

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

📈 Performance & Scalability

Pagination Support

All list endpoints support pagination with metadata:

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

Batch Operations

Bulk content updates
Mass media processing
Multi-site operations

Caching

Response caching
Query optimization
Efficient data fetching

🎯 Use Cases

Content Creators

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

Developers

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

Site Administrators

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

Agencies

✅ Client site management
✅ Deployment automation
✅ Content migration
✅ Maintenance workflows

⚠️ Important Notes

Danger Levels

Level	Description	Examples
🟢 Safe	Read-only operations	get_posts, list_themes
🟡 Moderate	Content modification	create_post, update_media
🔴 High	Destructive operations	delete_post, delete_user

Best Practices

🔒 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

🧪 Testing

Run the comprehensive test suite:

All tests

pnpm test

Specific suites

pnpm test:unit pnpm test:integration

With coverage

pnpm test:coverage

📚 Documentation

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

🤝 Contributing

⚠️ Private Repository - This is maintained by Deusware AB development team. Contributions are limited to approved team members.

For approved team members:

Create feature branch
Write tests
Follow coding standards
Submit PR for review

**Want to join the team?**Contact: [email protected]

🎸 The Team

Deusware AB

Amadeus Samiel H. (CTO/Lead Architect)

MSc in Computer Science
20+ years of technical excellence
Instructor at LIU
The mind behind Claudeus WP MCP

Simon Malki (CEO)

20+ years of business leadership
Strategic planning expert
Driving Deusware's vision

Locations:

📍 Stockholm HQ: Krögers Promenad 11, 191 37 Sollentuna
📍 Norrköping Division: Klingsbergsgatan 13, 603 54 Norrköping

🏆 Why This Sets the Standard

Claudeus WordPress MCP demonstrates:

✅ Complete MCP 2024-11-05 Spec Compliance
✅ 100% TypeScript with Strict Mode
✅ Comprehensive Test Coverage (95%+)
✅ Enterprise-Grade Security
✅ Professional Documentation
✅ Production-Ready Quality

This isn't just a WordPress tool - it's a reference implementation showing how MCP servers should be built!

📊 Impact & Savings

Resource	Traditional Cost	With Claudeus MCP
Content Writer	$500/month	Included
SEO Expert	$1000/month	Included
Developer Time	$2000/month	Reduced 85%
Total	$3,500/month	$20/month (Claude Pro)

Monthly Savings: $3,480 (99.4% reduction) 🔥

🤘 License

MIT License - Rock on!

🧙‍♂️ Words of Wisdom

npm is not a package manager, it's a repository of packages. If you want a dependable package manager, always use pnpm
— Amadeus Samiel H.

Made with 🤘❤️ by Amadeus Samiel H.

145 Tools. Zero Compromise. Pure Metal. 🎸🔥

MseeP.ai Security Assessment Badge

Claudeus WordPress MCP Server

Documentation

🤘 Claudeus WordPress MCP 🎸

🔥 The Complete WordPress AI Powerhouse

⚡ What Makes It Legendary?

🎸 Complete WordPress Ecosystem Coverage

💪 Enterprise-Grade Architecture

🚀 Built for AI

📊 Complete Tool Inventory

1. Content Management (25 tools)

Posts, Pages & Blocks

Revisions & Autosaves (18 tools)

2. Media & Assets (6 tools)

3. Taxonomies (12 tools)

Categories

Tags

Taxonomy Discovery

4. User Management (10 tools)

5. Comments & Moderation (8 tools)

6. Menus & Navigation (10 tools)

Classic Menus

Locations

7. Full Site Editing - FSE (27 tools)

Templates & Template Parts (10 tools)

Global Styles (6 tools)

Block Patterns (3 tools)

Navigation Blocks (8 tools included in menus)

8. Astra Pro Integration (11 tools)

Mega Menus (4 tools)

Custom Layouts & Advanced Hooks (5 tools)

Theme Settings (2 tools)

9. Site Configuration (15 tools)

Site Settings (5 tools)

Plugins (5 tools)

Widgets & Sidebars (7 tools)

Theme Management (2 tools)

10. Site Health & Diagnostics (8 tools)

11. Search & Discovery (5 tools)

12. WooCommerce (3 tools)

13. System Discovery (5 tools)

🚀 Quick Start

Prerequisites

Installation

Via NPM (Recommended)

Install globally

Or use directly with npx

For Development

Clone repository

Install dependencies

Build

Test with Inspector UI

⚙️ Configuration

1. Create wp-sites.json

Getting Your Application Password

2. Configure Claude Desktop

3. Restart Claude Desktop

🎸 Using the MCP Inspector

Launch Inspector

Opens browser at http://localhost:5173

💪 Architecture Highlights

Modular Design

Key Features

🔒 Security Features

Authentication

Validation

Protection

📈 Performance & Scalability

Pagination Support

Batch Operations

Caching

🎯 Use Cases

Content Creators

Developers

Site Administrators

Agencies

⚠️ Important Notes

Danger Levels

Best Practices

🧪 Testing

All tests