MCP WordPress Server

A server for integrating with the WordPress REST API.

A comprehensive Model Context Protocol (MCP) server for WordPress management through the WordPress REST API v2. Completely written in TypeScript for maximum type safety and better developer experience.

- 54 WordPress Management Toolsacross 8 categories
- 100% TypeScript- Complete type safety and IntelliSense
- Modern ES Modules- Optimized for performance
- Interactive Setup Wizard- Easy configuration
- Comprehensive Testing- Complete test suite
- Flexible Authentication- Supports App Passwords, JWT, Basic Auth
- Debug & Monitoring- Structured logging and error tracking

The easiest way to get started - no installation required:

# Run directly with NPX npx @aiondadotcom/mcp-wordpress # Or install globally npm install -g @aiondadotcom/mcp-wordpress mcp-wordpress

git clone https://github.com/AiondaDotCom/mcp-wordpress.git cd mcp-wordpress npm install npm run setup npm start

# For NPX users npx @aiondadotcom/mcp-wordpress setup # For local installation npm run setup

- WordPress site configuration
- Authentication method selection
- Connection testing
- Claude Desktop configuration

If you want the absolute easiest setup, just paste this prompt into Claude Desktop:

Set up the MCP WordPress server using NPX for my Claude Desktop. My WordPress details: - Site URL: [YOUR_WORDPRESS_URL] - Username: [YOUR_USERNAME] Please: 1. Help me create a WordPress Application Password 2. Configure my Claude Desktop mcp.json file with the NPX command 3. Test the connection to make sure everything works 4. Show me how to use the WordPress tools I want to use the NPX version (@aiondadotcom/mcp-wordpress) so I don't need to install anything locally.

For local development and customization:

Build and configure the MCP WordPress server project from https://github.com/AiondaDotCom/mcp-wordpress locally on my computer. Please: 1. Clone the repository to an appropriate directory 2. Install all dependencies 3. Run the setup wizard and help me configure my WordPress connection 4. Test the connection to make sure everything works 5. Set up the Claude Desktop MCP configuration 6. Run a quick test to verify all tools are working My WordPress site URL is: [YOUR_WORDPRESS_URL] My WordPress username is: [YOUR_USERNAME] Guide me through any steps that require manual input, and let me know if you need any additional information from me.

Just replace[YOUR_WORDPRESS_URL]and[YOUR_USERNAME]with your actual WordPress site details, and Claude will handle the rest!

WORDPRESS_SITE_URL=https://your-wordpress-site.com WORDPRESS_USERNAME=your-username WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx WORDPRESS_AUTH_METHOD=app-password DEBUG=false

Configure MCP WordPress Server in your Claude Desktopmcp.jsonconfiguration file:

{ "mcpServers": { "mcp-wordpress": { "command": "npx", "args": ["@aiondadotcom/mcp-wordpress"], "env": { "WORDPRESS_SITE_URL": "https://your-site.com", "WORDPRESS_USERNAME": "your-username", "WORDPRESS_APP_PASSWORD": "your-app-password", "WORDPRESS_AUTH_METHOD": "app-password" } } } }

{ "mcpServers": { "mcp-wordpress": { "command": "mcp-wordpress", "env": { "WORDPRESS_SITE_URL": "https://your-site.com", "WORDPRESS_USERNAME": "your-username", "WORDPRESS_APP_PASSWORD": "your-app-password", "WORDPRESS_AUTH_METHOD": "app-password" } } } }

{ "mcpServers": { "mcp-wordpress": { "command": "node", "args": ["/path/to/mcp-wordpress/dist/index.js"], "env": { "WORDPRESS_SITE_URL": "https://your-site.com", "WORDPRESS_USERNAME": "your-username", "WORDPRESS_APP_PASSWORD": "your-app-password", "WORDPRESS_AUTH_METHOD": "app-password" } } } }

If you prefer to use a.envfile instead of environment variables in the config:

{ "mcpServers": { "mcp-wordpress": { "command": "npx", "args": ["@aiondadotcom/mcp-wordpress"], "env": { "NODE_ENV": "production" } } } }

Claude Desktop Configuration File Locations

- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- Linux:~/.config/Claude/claude_desktop_config.json
- Create or locate your Claude Desktop config fileat the path above
- Add the MCP server configurationusing one of the options above
- Restart Claude Desktopfor changes to take effect
- Verify the connection- you should see WordPress tools available in Claude Desktop

Here's a completeclaude_desktop_config.jsonfile with MCP WordPress:

{ "mcpServers": { "mcp-wordpress": { "command": "npx", "args": ["@aiondadotcom/mcp-wordpress"], "env": { "WORDPRESS_SITE_URL": "https://your-site.com", "WORDPRESS_USERNAME": "your-username", "WORDPRESS_APP_PASSWORD": "your-app-password", "WORDPRESS_AUTH_METHOD": "app-password" } } } }

# Compile npm run build # Watch mode npm run build:watch # Type checking npm run typecheck

# Development mode with debug output npm run dev # Check status npm run status # Re-run setup npm run setup

WordPress Application Passwords (Recommended)

# JWT Authentication (requires JWT plugin) WORDPRESS_AUTH_METHOD=jwt WORDPRESS_JWT_SECRET=your-jwt-secret # Basic Authentication (not recommended for production) WORDPRESS_AUTH_METHOD=basic WORDPRESS_PASSWORD=your-actual-password # API Key Authentication (requires API Key plugin) WORDPRESS_AUTH_METHOD=api-key WORDPRESS_API_KEY=your-api-key

- wp_list_posts- List and filter blog posts
- wp_get_post- Get specific post
- wp_create_post- Create new posts
- wp_update_post- Edit posts
- wp_delete_post- Delete posts
- wp_get_post_revisions- Get post revisions

- wp_list_pages- List pages
- wp_get_page- Get specific page
- wp_create_page- Create new pages
- wp_update_page- Edit pages
- wp_delete_page- Delete pages
- wp_get_page_revisions- Get page revisions

- wp_list_media- Browse media library
- wp_get_media- Get media details
- wp_upload_media- Upload files
- wp_update_media- Edit media metadata
- wp_delete_media- Delete media
- wp_get_media_sizes- Get available image sizes

- wp_list_users- List users
- wp_get_user- Get user details
- wp_create_user- Create new users
- wp_update_user- Edit user profiles
- wp_delete_user- Delete users
- wp_get_current_user- Get current user

- wp_list_comments- List comments
- wp_get_comment- Get comment details
- wp_create_comment- Create new comments
- wp_update_comment- Edit comments
- wp_delete_comment- Delete comments
- wp_approve_comment- Approve comments
- wp_spam_comment- Mark comments as spam

- wp_list_categories- List categories
- wp_get_category- Get category details
- wp_create_category- Create new categories
- wp_update_category- Edit categories
- wp_delete_category- Delete categories
- wp_list_tags- List tags
- wp_get_tag- Get tag details
- wp_create_tag- Create new tags
- wp_update_tag- Edit tags
- wp_delete_tag- Delete tags

- wp_get_site_settings- Get site settings
- wp_update_site_settings- Update site settings
- wp_get_site_stats- Get site statistics
- wp_search_site- Site-wide search
- wp_get_application_passwords- List app passwords
- wp_create_application_password- Create new app passwords
- wp_delete_application_password- Delete app passwords

- wp_test_auth- Test authentication
- wp_get_auth_status- Get authentication status
- wp_start_oauth_flow- Start OAuth flow
- wp_complete_oauth_flow- Complete OAuth flow
- wp_refresh_oauth_token- Refresh OAuth token
- wp_switch_auth_method- Switch authentication method

# Run all tests npm test # Tests with coverage npm run test:coverage # Quick tests npm run test:fast # MCP integration tests npm run test:mcp # Tool integration tests npm run test:tools # Tests in watch mode npm run test:watch

# Check connection status npm run status # Debug mode DEBUG=true npm run dev # Lint code npm run lint # Auto-fix linting errors npm run lint:fix

mcp-wordpress/ ├── src/ # TypeScript source code │ ├── index.ts # Main MCP server │ ├── server.ts # Server compatibility │ ├── types/ # TypeScript definitions │ │ ├── wordpress.ts # WordPress API types │ │ ├── mcp.ts # MCP protocol types │ │ ├── client.ts # Client interface types │ │ └── index.ts # Type exports │ ├── client/ # WordPress API client │ │ ├── api.ts # HTTP client │ │ └── auth.ts # Authentication │ ├── tools/ # MCP tool implementations │ │ ├── posts.ts # Post management │ │ ├── pages.ts # Page management │ │ ├── media.ts # Media management │ │ ├── users.ts # User management │ │ ├── comments.ts # Comment management │ │ ├── taxonomies.ts # Categories/Tags │ │ ├── site.ts # Site settings │ │ └── auth.ts # Authentication │ └── utils/ # Utility functions │ └── debug.ts # Debug logger ├── dist/ # Compiled JavaScript files ├── bin/ # Utility scripts │ ├── setup.js # Setup wizard │ └── status.js # Status checker ├── tests/ # Test suite ├── scripts/ # Build and test scripts ├── tsconfig.json # TypeScript configuration ├── jest.config.json # Jest test configuration └── package.json # Node.js project configuration

- Complete Type Safety- Compile-time validation
- IntelliSense Support- Better IDE integration
- Type-safe API Client- Typed HTTP methods
- Comprehensive WordPress Types- 400+ lines of precise definitions
- MCP Protocol Types- Tool definitions and handlers
- Enhanced Error Handling- Typed exceptions
- Source Maps- Debugging support

- WordPress 5.0+with REST API enabled
- HTTPS(recommended for production)
- User with appropriate permissions
- Application Passwordsenabled (WordPress 5.6+)

- Check WORDPRESS_SITE_URL
- Ensure REST API is accessible
- Test:curl https://your-site.com/wp-json/wp/v2/

- Verify username and app password
- Ensure Application Passwords are enabled
- Try runningnpm run setupagain

"TypeScript compilation errors"

- Runnpm run typecheck
- Ensure all dependencies are installed

- WordPress REST API
- Model Context Protocol
- TypeScript Handbook
- Fork the repository
- Create feature branch:git checkout -b feature/new-feature
- Commit changes:git commit -m 'Add new feature'
- Push branch:git push origin feature/new-feature
- Create pull request

An MCP server for WordPress and Elementor, enabling AI assistants to manage content and build pages.