Yoast SEO MCP · Free
Yoast SEO MCP: bulk-edit Yoast metadata from a prompt.
A Yoast SEO MCP server lets an AI agent read and write the fields in the Yoast box under every post, without anyone opening those posts one by one. WP MCP writes Yoast's own fields, snapshots each write, and can undo an entire bulk run.
Self-hosted · snapshot before every write · one-click undo
› Write meta descriptions for every blog post that has none
get-seo-meta 118 posts read, 37 without a description
⛨ one per post, one session
update-seo-meta Yoast fields written, 37 posts
✓ 37 descriptions added. One click undoes the whole run.
What it is
What a Yoast SEO MCP server does.
Most Yoast sites carry a backlog: posts with no meta description, titles that were never customised, keyphrases left empty. Clearing it by hand means opening each post. A Yoast SEO MCP server turns that into a conversation: the agent reads the current values, drafts new ones, and writes them in.
WP MCP writes through Yoast SEO's own fields, so your templates and settings stay as they are. The agent is just doing the typing, and it leaves a restore point behind every keystroke.
The Yoast box under each post holds the title, meta description, focus keyphrase, canonical and robots flags, and editing it across a large blog is the kind of work that is dull by hand and risky in bulk. WP MCP writes Yoast's own fields, snapshots the old values before each write, and treats a whole run as a session. Tone wrong on the new descriptions, or a flag applied too widely, is one click to undo for every post.
Read and change
What WP MCP can read and change in Yoast SEO.
It can read
- Yoast SEO title, meta description and focus keyphrase for a post
- Canonical URL and noindex or nofollow flags
- Which SEO plugin is active, and its status
It can change
- Rewrite SEO titles and meta descriptions
- Set focus keyphrases
- Set canonical URLs
- Set or clear noindex and nofollow
These are the real ability and operation names the agent calls. TheYoast SEO AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
Which published posts have an empty Yoast meta description?
Rewrite the SEO titles on the blog so each is under 60 characters and keeps its keyphrase.
Set these five landing pages to noindex, then show me exactly what changed.
Which published posts have an empty Yoast meta description?
get-seo-meta reads posts and the agent reports the empty ones; no writes happen.
Rewrite the SEO titles on the blog so each is under 60 characters and keeps its keyphrase.
update-seo-meta changes titles under one session, with a snapshot of each post's old title.
Set these five landing pages to noindex, then show me exactly what changed.
The flags are set per post and the before-images show old and new values; rollback-session reverses all five.
Safety
Every Yoast SEO write has a way back.
Yoast's per-post values are post meta, so the post snapshot holds the old title, description and flags before each write. A bulk run shares one session, so rollback-session restores every post it touched, and rollback-operation restores just one.
Snapshot before every write
No tool that writes can skip it. The before-state is saved first, the change is applied second.
One-click undo
Restore a single change with rollback-operation or a whole agent run with rollback-session, from the agent or from wp-admin.
Bulk runs roll back as one
A run across hundreds of posts is one session. If the tone is wrong or a flag went too wide, one click restores every post.
Free or Pro
Free.
Yoast SEO support is in the free plugin, together with the snapshot and rollback engine. WP MCP Pro adds unlimited snapshot history and SEO metadata for taxonomy terms.
The free plugin is GPL and has no trial clock. See pricing for what each tier includes.
How to connect
Connect Yoast SEO MCP in four steps.
- 01Install WP MCP
Upload the free wpmcp plugin and activate it. It needs WordPress 6.9 or newer and PHP 8.1 or newer, and it runs entirely on your own server.
- 02Check the requirement
Yoast SEO active.
- 03Connect your client
Add the site to Claude Code, Claude Desktop, Cursor or any MCP client with a WordPress application password, or the WP-CLI stdio bridge locally. OAuth 2.1 with full or read-only access is there too, once the site owner switches it on.
- 04Ask for the change
Describe what you want done in Yoast SEO. WP MCP snapshots the target, makes the change, and leaves a Restore button next to it in wp-admin.
Step-by-step guides: Claude,Claude Code andCursor. The docscover the safety model in full.
Frequently asked
Yoast SEO MCP: questions, answered.
What is Yoast SEO MCP?
It is Yoast SEO's per-post metadata made readable and writable by AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client bulk-edit titles, descriptions, keyphrases, canonicals and robots flags.
Is Yoast MCP free?
Yes. Yoast SEO support and the undo engine are in the free WP MCP plugin, and it works with the free version of Yoast SEO.
Does WP MCP change my Yoast configuration?
No. It writes the same per-post fields the Yoast box writes. Templates and site-wide settings are not touched.
What if a bulk rewrite goes wrong?
Every write is snapshotted and grouped into a session, so the entire run can be rolled back in one click.
Does it work with Yoast SEO Premium?
It works with the per-post fields that the free and Premium versions share: title, description, keyphrase, canonical and robots.
Does it cover Yoast SEO Premium features?
It writes the per-post fields listed on this page: title, description, keyphrase, canonical and robots flags. It does not claim anything beyond those.
What does WP MCP Pro add for Yoast sites?
Unlimited snapshot history and SEO metadata for taxonomy terms. The post-level reading and writing is in the free plugin.
Does Yoast SEO MCP work with Claude, Claude Code and Cursor?
Yes. Claude Code and Cursor connect to WP MCP over HTTP with a WordPress application password, and Claude Desktop uses the desktop bundle from the WP MCP Connection screen. Clients that can only sign in with OAuth, such as the claude.ai custom connector, need OAuth switched on first with one line in wp-config.php, because it ships off. Once connected, the Yoast SEO tools are available in every client the same way.
Keep exploring
MCP for Yoast SEO →
Bulk-edit Yoast metadata across the whole site from a prompt, every change reversible.
Rank Math MCP →
A Rank Math MCP server lets an AI agent read and write the SEO fields Rank Math manages, across as many posts as you point it at.
ACF MCP →
An ACF MCP server lets an AI agent understand your content model and work with it: see which fields a post type has, fill them in, or add a new field group.
WPForms MCP →
A WPForms MCP server lets an AI agent read your forms and what they collect.
Contact Form 7 MCP →
A Contact Form 7 MCP server lets an AI agent answer the questions you normally click around for: which forms exist, who each one emails, what came in this week.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.