wp_list_users
List WordPress users with filtering by search term or role. Returns detailed user info including roles, registration dates, and activity status, with restrictions for non-admins.
Instructions
Lists users from a WordPress site with comprehensive filtering and detailed user information including roles, registration dates, and activity status.
Note: Role, email, and registration date fields require administrator privileges. Non-admin users will see limited metadata due to WordPress REST API restrictions.
Usage Examples:
• List all users: wp_list_users
• Search users: wp_list_users --search="john"
• Filter by role: wp_list_users --roles=["editor","author"]
• Find admins: wp_list_users --roles=["administrator"]
• Combined search: wp_list_users --search="smith" --roles=["subscriber"]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | No | The ID of the WordPress site to target (from mcp-wordpress.config.json). Required if multiple sites are configured. | |
| search | No | Limit results to those matching a search term. | |
| roles | No | Limit results to users with specific roles. |