wp_list_media is one of 162 MCP tools included in Easy MCP AI β the WordPress plugin that connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin βwp_list_media
Read-onlyDescription
Finding the right asset is the first step in almost every media workflow β Easy MCP AI exposes your entire WordPress media library to AI clients so they can search, filter, and surface the correct file before taking any action. You can ask Claude.ai or ChatGPT to list images uploaded this week, show all PDFs, or find unattached files, all without opening the WordPress dashboard. Easy MCP AI returns the results directly to your AI client, which can then chain into upload, update, or post-assignment tools in the same conversation.
See it in action
wp_list_media {
"total": 24,
"items": [
{ "media_id": 189, "title": "Team Offsite", "mime_type": "image/jpeg" },
{ "media_id": 175, "title": "Hero Banner", "mime_type": "image/png" },
{ "media_id": 163, "title": "Blog Cover March", "mime_type": "image/webp" }
]
} Found 24 items in your media library. Showing the most recent.
Example Use Cases & Sample Prompts
- Finding recent uploads
- Prompt: βList all media uploaded in the last 7 days.β
- Image-only audit
- Prompt: βList all images in the media library uploaded before 2023 so I can review what to clean up.β
- PDF catalog
- Prompt: βShow me all PDFs currently in the media library.β
- Finding unattached media
- Prompt: βList all media items that are not attached to any post or page.β
- Storage audit
- Prompt: βHow many total media files do I have? List the most recent 20.β
Frequently Asked Questions
What does wp_list_media do?
Finding the right asset is the first step in almost every media workflow β Easy MCP AI exposes your entire WordPress media library to AI clients so they can search, filter, and surface the correct file before taking any action. You can ask Claude.ai or ChatGPT to list images uploaded this week, show all PDFs, or find unattached files, all without opening the WordPress dashboard. Easy MCP AI returns the results directly to your AI client, which can then chain into upload, update, or post-assignment tools in the same conversation.
How do I use wp_list_media with my AI assistant?
Install the Easy MCP AI WordPress plugin, generate an API token in your dashboard, and connect your AI client (Claude, ChatGPT, Cursor, or any MCP-compatible assistant). Then simply describe what you want in natural language β for example: "Show me all images uploaded in the last 30 days."
Do I need Easy MCP AI to use wp_list_media?
Yes. wp_list_media is one of 162 MCP tools bundled inside the Easy MCP AI WordPress plugin. Install the free plugin from WordPress.org, connect your AI client, and this tool becomes available immediately β no coding required.
Related Tools
MediaPermanently delete a media file from the WordPress media library by ID
Retrieve the full metadata of a specific media file by ID
Update the title, alt text, caption, or description of a media file by ID
Upload an image or file from a URL directly into the WordPress media library
Step 1
Get the Plugin
Install Easy MCP AI on your WordPress site to unlock wp_list_media and all 74 tools instantly.
Step 2
Connect Your AI Client
Already have the plugin? Step-by-step setup guides for Claude, ChatGPT, Cursor, Windsurf, and 10+ more.