← Back to Tools Reference

wp_list_posts

Read-only

Description

Use this tool to browse or search through your posts with filters like status (draft, published, scheduled), category, tag, author, or a keyword. This is normally the first step before editing, deleting, or reviewing a specific post — you list posts to find the one you want to work with, then use other tools to act on it.

See it in action

Claude Desktop — MCP Connection
👤
Show me all my current draft posts so I can decide which ones to publish.
🤖
Calling Tool: wp_list_posts
Done! I've used wp_list_posts to complete that for you.
{"status": "success"}

Example Use Cases & Sample Prompts

  1. Finding draft posts
    • Prompt: “Show me all my current draft posts so I can decide which ones to publish.”
  2. Content audit by category
    • Prompt: “List all posts in the ‘Tutorials’ category and tell me how many there are.”
  3. Checking scheduled posts
    • Prompt: “What posts do I have scheduled to go live this week?”
  4. Finding posts to update
    • Prompt: “List all posts from more than a year ago that are still published — I want to review if they need refreshing.”
  5. Browsing by author
    • Prompt: “Show me all published posts written by the user ‘editor_jane’ from the last 3 months.”

Access this tool today

Install the Easy MCP AI plugin to securely expose wp_list_posts to Claude, ChatGPT, and more.

Download Plugin