Skip to content

Davidi18/wordpress-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

WordPress MCP Server v2.0 - Enhanced Edition

πŸŽ‰ What's New in v2.0

35 Total Endpoints (up from 18) - 94% increase in functionality!

New Features Added:

πŸ“ Media Management - COMPLETE

  • βœ… wp_get_media - List all media files
  • βœ… wp_get_media_item - Get specific media item
  • βœ… wp_upload_media - Upload new media
  • ✨ NEW wp_update_media - Update metadata (title, alt text, caption, description)
  • ✨ NEW wp_delete_media - Delete media files

πŸ’¬ Comments - FULL CRUD

  • ✨ NEW wp_get_comments - List comments with filters
  • ✨ NEW wp_get_comment - Get specific comment
  • ✨ NEW wp_create_comment - Create new comments
  • ✨ NEW wp_update_comment - Update comment content/status
  • ✨ NEW wp_delete_comment - Delete comments

πŸ‘₯ Users

  • ✨ NEW wp_get_users - List all users
  • ✨ NEW wp_get_user - Get specific user details
  • ✨ NEW wp_get_current_user - Get authenticated user info

🏷️ Taxonomy - FULL CRUD

  • βœ… wp_get_categories - List categories
  • βœ… wp_get_tags - List tags
  • ✨ NEW wp_create_category - Create new categories
  • ✨ NEW wp_create_tag - Create new tags
  • ✨ NEW wp_update_category - Update category details
  • ✨ NEW wp_delete_category - Delete categories

βš™οΈ Site Information

  • ✨ NEW wp_get_site_info - Get site settings and configuration
  • ✨ NEW wp_get_post_types - List all available post types

πŸ“Š Complete Endpoint Coverage

Posts (5 endpoints)

  • wp_get_posts - List posts with filters
  • wp_get_post - Get single post
  • wp_create_post - Create new post
  • wp_update_post - Update existing post
  • wp_delete_post - Delete post

Pages (5 endpoints)

  • wp_get_pages - List pages
  • wp_get_page - Get single page
  • wp_create_page - Create new page
  • wp_update_page - Update existing page
  • wp_delete_page - Delete page

Media (5 endpoints) ✨

  • wp_get_media - List media files
  • wp_get_media_item - Get single media item
  • wp_upload_media - Upload new media
  • wp_update_media ← NEW!
  • wp_delete_media ← NEW!

Comments (5 endpoints) ✨ ALL NEW!

  • wp_get_comments - List comments
  • wp_get_comment - Get single comment
  • wp_create_comment - Create new comment
  • wp_update_comment - Update comment
  • wp_delete_comment - Delete comment

Users (3 endpoints) ✨ ALL NEW!

  • wp_get_users - List all users
  • wp_get_user - Get user details
  • wp_get_current_user - Get current user

Custom Post Types (3 endpoints)

  • wp_get_custom_posts - List custom posts
  • wp_get_custom_post - Get single custom post
  • wp_create_custom_post - Create custom post

Taxonomy (6 endpoints) ✨ 4 NEW!

  • wp_get_categories - List categories
  • wp_get_tags - List tags
  • wp_create_category ← NEW!
  • wp_create_tag ← NEW!
  • wp_update_category ← NEW!
  • wp_delete_category ← NEW!

Site Info (2 endpoints) ✨ ALL NEW!

  • wp_get_site_info - Site settings
  • wp_get_post_types - Available post types

πŸš€ Usage Examples

Update Media Metadata

{
  "tool": "wp_update_media",
  "args": {
    "id": 123,
    "title": "Beautiful Sunset",
    "alt_text": "A stunning sunset over the ocean",
    "caption": "Taken at Santa Monica Beach",
    "description": "High-resolution sunset photograph"
  }
}

Create and Manage Comments

// Create comment
{
  "tool": "wp_create_comment",
  "args": {
    "post": 42,
    "content": "Great article!",
    "author_name": "John Doe",
    "author_email": "john@example.com"
  }
}

// Update comment status
{
  "tool": "wp_update_comment",
  "args": {
    "id": 15,
    "status": "approve"
  }
}

Manage Categories

// Create category
{
  "tool": "wp_create_category",
  "args": {
    "name": "Technology",
    "description": "Tech-related articles",
    "slug": "tech"
  }
}

// Update category
{
  "tool": "wp_update_category",
  "args": {
    "id": 5,
    "name": "Tech & Innovation",
    "parent": 2
  }
}

Get Site Information

{
  "tool": "wp_get_site_info",
  "args": {}
}
// Returns: title, description, url, timezone, language, etc.

πŸ“ˆ API Coverage Statistics

Content Type Before v2.0 After v2.0 Coverage
Posts 5 endpoints 5 endpoints 100% βœ…
Pages 5 endpoints 5 endpoints 100% βœ…
Media 3 endpoints 5 endpoints 100% βœ…
Comments 0 endpoints 5 endpoints 100% ✨
Users 0 endpoints 3 endpoints 75% ✨
Taxonomy 2 endpoints 6 endpoints 100% ✨
Custom Posts 3 endpoints 3 endpoints 100% βœ…
Site Info 0 endpoints 2 endpoints NEW ✨
TOTAL 18 endpoints 35 endpoints 94% more!

πŸ”§ Installation

No changes to installation process - same as before:

# Clone the repo
git clone https://github.com/Davidi18/wordpress-mcp.git
cd wordpress-mcp

# Set up environment
cp .env.example .env
# Edit .env with your WordPress credentials

# Run
npm start

🌟 Why This Update Matters

  1. Complete Content Management - Full CRUD operations on all WordPress content types
  2. Media Workflow - Now you can update media metadata without re-uploading
  3. Comment Moderation - Manage comments programmatically
  4. User Management - Query and manage WordPress users
  5. Taxonomy Control - Create and organize categories/tags dynamically
  6. Site Intelligence - Get site configuration and post type information

🎯 Perfect For

  • πŸ€– AI-powered content management systems
  • πŸ“± Headless WordPress implementations
  • πŸ”„ Content synchronization tools
  • πŸ“Š WordPress data analytics
  • πŸ› οΈ Automation workflows
  • πŸ”Œ Third-party integrations

πŸ“ Changelog v2.0.0

Added

  • Media update and delete endpoints
  • Complete comments CRUD system
  • User management endpoints
  • Category and tag creation/update/delete
  • Site information endpoints
  • Enhanced error handling
  • Better response formatting

Improved

  • Updated server version to 2.0.0
  • Enhanced tool descriptions
  • More detailed input schemas
  • Better TypeScript compatibility

🀝 Contributing

Found a bug or want to add more endpoints? PRs are welcome!

πŸ“„ License

MIT License - see LICENSE file for details


πŸ™ Credits

Enhanced by Claude & n8n-MCP tools integration Original by @Davidi18

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published