Tools

WordPress

Manage WordPress content

Usage Instructions

Integrate with WordPress to create, update, and manage posts, pages, media, comments, categories, tags, and users. Supports WordPress.com sites via OAuth and self-hosted WordPress sites using Application Passwords authentication.

Tools

`wordpress_create_post`

Create a new blog post in WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`title`	string	Yes	Post title
`content`	string	No	Post content (HTML or plain text)
`status`	string	No	Post status: publish, draft, pending, private, or future
`excerpt`	string	No	Post excerpt
`categories`	string	No	Comma-separated category IDs
`tags`	string	No	Comma-separated tag IDs
`featuredMedia`	number	No	Featured image media ID
`slug`	string	No	URL slug for the post

Output

Parameter	Type	Description
`post`	object	The created post

`wordpress_update_post`

Update an existing blog post in WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`postId`	number	Yes	The ID of the post to update
`title`	string	No	Post title
`content`	string	No	Post content (HTML or plain text)
`status`	string	No	Post status: publish, draft, pending, private, or future
`excerpt`	string	No	Post excerpt
`categories`	string	No	Comma-separated category IDs
`tags`	string	No	Comma-separated tag IDs
`featuredMedia`	number	No	Featured image media ID
`slug`	string	No	URL slug for the post

Output

Parameter	Type	Description
`post`	object	The updated post

`wordpress_delete_post`

Delete a blog post from WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`postId`	number	Yes	The ID of the post to delete
`force`	boolean	No	Bypass trash and force delete permanently

Output

Parameter	Type	Description
`deleted`	boolean	Whether the post was deleted
`post`	object	The deleted post

`wordpress_get_post`

Get a single blog post from WordPress.com by ID

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`postId`	number	Yes	The ID of the post to retrieve

Output

Parameter	Type	Description
`post`	object	The retrieved post

`wordpress_list_posts`

List blog posts from WordPress.com with optional filters

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`perPage`	number	No	Number of posts per page (default: 10, max: 100)
`page`	number	No	Page number for pagination
`status`	string	No	Post status filter: publish, draft, pending, private
`author`	number	No	Filter by author ID
`categories`	string	No	Comma-separated category IDs to filter by
`tags`	string	No	Comma-separated tag IDs to filter by
`search`	string	No	Search term to filter posts
`orderBy`	string	No	Order by field: date, id, title, slug, modified
`order`	string	No	Order direction: asc or desc

Output

Parameter	Type	Description
`posts`	array	List of posts
`total`	number	Total number of posts
`totalPages`	number	Total number of pages

`wordpress_create_page`

Create a new page in WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`title`	string	Yes	Page title
`content`	string	No	Page content (HTML or plain text)
`status`	string	No	Page status: publish, draft, pending, private
`excerpt`	string	No	Page excerpt
`parent`	number	No	Parent page ID for hierarchical pages
`menuOrder`	number	No	Order in page menu
`featuredMedia`	number	No	Featured image media ID
`slug`	string	No	URL slug for the page

Output

Parameter	Type	Description
`page`	object	The created page

`wordpress_update_page`

Update an existing page in WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`pageId`	number	Yes	The ID of the page to update
`title`	string	No	Page title
`content`	string	No	Page content (HTML or plain text)
`status`	string	No	Page status: publish, draft, pending, private
`excerpt`	string	No	Page excerpt
`parent`	number	No	Parent page ID for hierarchical pages
`menuOrder`	number	No	Order in page menu
`featuredMedia`	number	No	Featured image media ID
`slug`	string	No	URL slug for the page

Output

Parameter	Type	Description
`page`	object	The updated page

`wordpress_delete_page`

Delete a page from WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`pageId`	number	Yes	The ID of the page to delete
`force`	boolean	No	Bypass trash and force delete permanently

Output

Parameter	Type	Description
`deleted`	boolean	Whether the page was deleted
`page`	object	The deleted page

`wordpress_get_page`

Get a single page from WordPress.com by ID

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`pageId`	number	Yes	The ID of the page to retrieve

Output

Parameter	Type	Description
`page`	object	The retrieved page

`wordpress_list_pages`

List pages from WordPress.com with optional filters

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`perPage`	number	No	Number of pages per request (default: 10, max: 100)
`page`	number	No	Page number for pagination
`status`	string	No	Page status filter: publish, draft, pending, private
`parent`	number	No	Filter by parent page ID
`search`	string	No	Search term to filter pages
`orderBy`	string	No	Order by field: date, id, title, slug, modified, menu_order
`order`	string	No	Order direction: asc or desc

Output

Parameter	Type	Description
`pages`	array	List of pages
`total`	number	Total number of pages
`totalPages`	number	Total number of result pages

`wordpress_upload_media`

Upload a media file (image, video, document) to WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`file`	file	No	File to upload (UserFile object)
`filename`	string	No	Optional filename override (e.g., image.jpg)
`title`	string	No	Media title
`caption`	string	No	Media caption
`altText`	string	No	Alternative text for accessibility
`description`	string	No	Media description

Output

Parameter	Type	Description
`media`	object	The uploaded media item

`wordpress_get_media`

Get a single media item from WordPress.com by ID

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`mediaId`	number	Yes	The ID of the media item to retrieve

Output

Parameter	Type	Description
`media`	object	The retrieved media item

`wordpress_list_media`

List media items from the WordPress.com media library

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`perPage`	number	No	Number of media items per request (default: 10, max: 100)
`page`	number	No	Page number for pagination
`search`	string	No	Search term to filter media
`mediaType`	string	No	Filter by media type: image, video, audio, application
`mimeType`	string	No	Filter by specific MIME type (e.g., image/jpeg)
`orderBy`	string	No	Order by field: date, id, title, slug
`order`	string	No	Order direction: asc or desc

Output

Parameter	Type	Description
`media`	array	List of media items
`total`	number	Total number of media items
`totalPages`	number	Total number of result pages

`wordpress_delete_media`

Delete a media item from WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`mediaId`	number	Yes	The ID of the media item to delete
`force`	boolean	No	Force delete (media has no trash, so deletion is permanent)

Output

Parameter	Type	Description
`deleted`	boolean	Whether the media was deleted
`media`	object	The deleted media item

`wordpress_create_comment`

Create a new comment on a WordPress.com post

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`postId`	number	Yes	The ID of the post to comment on
`content`	string	Yes	Comment content
`parent`	number	No	Parent comment ID for replies
`authorName`	string	No	Comment author display name
`authorEmail`	string	No	Comment author email
`authorUrl`	string	No	Comment author URL

Output

Parameter	Type	Description
`comment`	object	The created comment

`wordpress_list_comments`

List comments from WordPress.com with optional filters

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`perPage`	number	No	Number of comments per request (default: 10, max: 100)
`page`	number	No	Page number for pagination
`postId`	number	No	Filter by post ID
`status`	string	No	Filter by comment status: approved, hold, spam, trash
`search`	string	No	Search term to filter comments
`orderBy`	string	No	Order by field: date, id, parent
`order`	string	No	Order direction: asc or desc

Output

Parameter	Type	Description
`comments`	array	List of comments
`total`	number	Total number of comments
`totalPages`	number	Total number of result pages

`wordpress_update_comment`

Update a comment in WordPress.com (content or status)

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`commentId`	number	Yes	The ID of the comment to update
`content`	string	No	Updated comment content
`status`	string	No	Comment status: approved, hold, spam, trash

Output

Parameter	Type	Description
`comment`	object	The updated comment

`wordpress_delete_comment`

Delete a comment from WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`commentId`	number	Yes	The ID of the comment to delete
`force`	boolean	No	Bypass trash and force delete permanently

Output

Parameter	Type	Description
`deleted`	boolean	Whether the comment was deleted
`comment`	object	The deleted comment

`wordpress_create_category`

Create a new category in WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`name`	string	Yes	Category name
`description`	string	No	Category description
`parent`	number	No	Parent category ID for hierarchical categories
`slug`	string	No	URL slug for the category

Output

Parameter	Type	Description
`category`	object	The created category

`wordpress_list_categories`

List categories from WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`perPage`	number	No	Number of categories per request (default: 10, max: 100)
`page`	number	No	Page number for pagination
`search`	string	No	Search term to filter categories
`order`	string	No	Order direction: asc or desc

Output

Parameter	Type	Description
`categories`	array	List of categories
`total`	number	Total number of categories
`totalPages`	number	Total number of result pages

`wordpress_create_tag`

Create a new tag in WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`name`	string	Yes	Tag name
`description`	string	No	Tag description
`slug`	string	No	URL slug for the tag

Output

Parameter	Type	Description
`tag`	object	The created tag

`wordpress_list_tags`

List tags from WordPress.com

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`perPage`	number	No	Number of tags per request (default: 10, max: 100)
`page`	number	No	Page number for pagination
`search`	string	No	Search term to filter tags
`order`	string	No	Order direction: asc or desc

Output

Parameter	Type	Description
`tags`	array	List of tags
`total`	number	Total number of tags
`totalPages`	number	Total number of result pages

`wordpress_get_current_user`

Get information about the currently authenticated WordPress.com user

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)

Output

Parameter	Type	Description
`user`	object	The current user

`wordpress_list_users`

List users from WordPress.com (requires admin privileges)

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`perPage`	number	No	Number of users per request (default: 10, max: 100)
`page`	number	No	Page number for pagination
`search`	string	No	Search term to filter users
`roles`	string	No	Comma-separated role names to filter by
`order`	string	No	Order direction: asc or desc

Output

Parameter	Type	Description
`users`	array	List of users
`total`	number	Total number of users
`totalPages`	number	Total number of result pages

`wordpress_get_user`

Get a specific user from WordPress.com by ID

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`userId`	number	Yes	The ID of the user to retrieve

Output

Parameter	Type	Description
`user`	object	The retrieved user

`wordpress_search_content`

Search across all content types in WordPress.com (posts, pages, media)

Input

Parameter	Type	Required	Description
`siteId`	string	Yes	WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
`query`	string	Yes	Search query
`perPage`	number	No	Number of results per request (default: 10, max: 100)
`page`	number	No	Page number for pagination
`type`	string	No	Filter by content type: post, page, attachment
`subtype`	string	No	Filter by post type slug (e.g., post, page)

Output

Parameter	Type	Description
`results`	array	Search results
`total`	number	Total number of results
`totalPages`	number	Total number of result pages

Notes

Category: tools
Type: wordpress

On this page

On this page

Usage Instructions

wordpress_create_post

wordpress_update_post

wordpress_delete_post

wordpress_get_post

wordpress_list_posts

wordpress_create_page

wordpress_update_page

wordpress_delete_page

wordpress_get_page

wordpress_list_pages

wordpress_upload_media

wordpress_get_media

wordpress_list_media

wordpress_delete_media

wordpress_create_comment

wordpress_list_comments

wordpress_update_comment

wordpress_delete_comment

wordpress_create_category

wordpress_list_categories

wordpress_create_tag

wordpress_list_tags

wordpress_get_current_user

wordpress_list_users

wordpress_get_user

wordpress_search_content

WordPress