wp_list_postsLABSCO SUMMARY
Authentication is a first-class part of the tool surface.
Six of the 54 tools exist purely to test, report on and switch authentication — which sounds like padding until the first time a WordPress connection silently fails and you cannot tell whether it is the URL, the password or the plugin. Application passwords are the recommended path; the fallbacks are there because plenty of real installs cannot use them.
What it is
A TypeScript server covering the WordPress REST API v2 broadly rather than selectively. It runs a setup wizard that walks you through the site, the authentication method and a connection test, then exposes the whole management surface — content, media, people and settings — as tools.
What you get
- Posts (6):
wp_list_posts,wp_get_post,wp_create_post,wp_update_post,wp_delete_post,wp_get_post_revisions - Pages (6): the same shape for pages, including
wp_get_page_revisions - Media (6):
wp_list_media,wp_get_media,wp_upload_media,wp_update_media,wp_delete_media,wp_get_media_sizes - Users (6) and Comments (7): full CRUD plus
wp_get_current_user,wp_approve_commentandwp_spam_comment - Taxonomies (10): categories and tags, each with list, get, create, update and delete
- Site management (7):
wp_get_site_settings,wp_update_site_settings,wp_get_site_stats,wp_search_site, and the three application-password tools - Authentication (6):
wp_test_auth,wp_get_auth_status, the OAuth flow tools, andwp_switch_auth_method
Requirements
WordPress 5.0 or newer with the REST API enabled, and a user whose role carries the permissions you intend to use — an Administrator reaches everything, an Author only their own posts and media. Run it as npx @aiondadotcom/mcp-wordpress, or install globally with npm. Set WORDPRESS_SITE_URL, WORDPRESS_USERNAME, WORDPRESS_APP_PASSWORD and WORDPRESS_AUTH_METHOD; application passwords need WordPress 5.6 or newer and are created under Users → Profile. JWT, Basic and API-key authentication are also supported through the same WORDPRESS_AUTH_METHOD setting. npm run setup runs the wizard, npm run status checks the connection.
Setup effort
One command plus credentials — npx @aiondadotcom/mcp-wordpress, then supply credentials
USE CASES
01
Drafting and publishing without opening wp-admin
Create the post, attach media, then update the status when it is ready.
02
Clearing a comment backlog
List what is pending, approve the real ones and mark the rest as spam.
03
Tidying a category and tag structure
Read what exists, rename or merge, and delete what nobody uses.
04
Working out why the connection fails
Test authentication and read its status before touching anything else.
05
Recovering an earlier version of a page
Pull its revisions and put the right one back.
54 tools
Listed in project docs. Your client may show a different list.
wp_get_postwp_create_postwp_update_postwp_delete_postwp_get_post_revisionswp_list_pageswp_get_pagewp_create_pagewp_update_pagewp_delete_pagewp_get_page_revisionswp_list_mediawp_get_mediawp_upload_mediawp_update_mediawp_delete_mediawp_get_media_sizeswp_list_userswp_get_userwp_create_userwp_update_userwp_delete_userwp_get_current_userwp_list_commentswp_get_commentwp_create_commentwp_update_commentwp_delete_commentwp_approve_commentwp_spam_commentwp_list_categorieswp_get_categorywp_create_categorywp_update_categorywp_delete_categorywp_list_tagswp_get_tagwp_create_tagwp_update_tagwp_delete_tagwp_get_site_settingswp_update_site_settingswp_get_site_statswp_search_sitewp_get_application_passwordswp_create_application_passwordwp_delete_application_passwordwp_test_authwp_get_auth_statuswp_start_oauth_flowwp_complete_oauth_flowwp_refresh_oauth_tokenwp_switch_auth_methodBEFORE YOU INSTALL
What to know first
Tools you get
54 tools named in the project's documentation.
Requires
- npx on PATH
- WORDPRESS_APP_PASSWORD in your environment
- WORDPRESS_SITE_URL in your environment
- WORDPRESS_USERNAME in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @aiondadotcom/mcp-wordpressMCP Clients
Claude Desktop — npx
CLAUDE DESKTOP — NPX · JSON
{
"mcpServers": {
"mcp-wordpress": {
"command": "npx",
"args": [
"@aiondadotcom/mcp-wordpress"
],
"env": {
"WORDPRESS_SITE_URL": "<YOUR_WORDPRESS_SITE_URL>",
"WORDPRESS_USERNAME": "<YOUR_WORDPRESS_USERNAME>",
"WORDPRESS_APP_PASSWORD": "<YOUR_WORDPRESS_APP_PASSWORD>",
"WORDPRESS_AUTH_METHOD": "app-password"
}
}
}
}Claude Desktop — global npm
CLAUDE DESKTOP — GLOBAL NPM · TERMINAL
npm install -g @aiondadotcom/mcp-wordpressThen add this to your Claude Desktop config:
CLAUDE DESKTOP — GLOBAL NPM · JSON
{
"mcpServers": {
"mcp-wordpress": {
"command": "mcp-wordpress",
"env": {
"WORDPRESS_SITE_URL": "<YOUR_WORDPRESS_SITE_URL>",
"WORDPRESS_USERNAME": "<YOUR_WORDPRESS_USERNAME>",
"WORDPRESS_APP_PASSWORD": "<YOUR_WORDPRESS_APP_PASSWORD>",
"WORDPRESS_AUTH_METHOD": "app-password"
}
}
}
}Claude Desktop — local build
CLAUDE DESKTOP — LOCAL BUILD · TERMINAL
git clone https://github.com/AiondaDotCom/mcp-wordpress.git
cd mcp-wordpress
npm install
npm run buildThen add this to your Claude Desktop config:
CLAUDE DESKTOP — LOCAL BUILD · JSON
{
"mcpServers": {
"mcp-wordpress": {
"command": "node",
"args": [
"<YOUR_PATH_TO_MCP_WORDPRESS>/dist/index.js"
],
"env": {
"WORDPRESS_SITE_URL": "<YOUR_WORDPRESS_SITE_URL>",
"WORDPRESS_USERNAME": "<YOUR_WORDPRESS_USERNAME>",
"WORDPRESS_APP_PASSWORD": "<YOUR_WORDPRESS_APP_PASSWORD>",
"WORDPRESS_AUTH_METHOD": "app-password"
}
}
}
}<YOUR_PATH_TO_MCP_WORDPRESS> is the full path of your clone.
