Get the plugin
WP MCP/Integrations/Yoast SEO MCP

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

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
get-seo-metaupdate-seo-metaget-seo-statusrollback-session

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.

  1. 01
    Install 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.

  2. 02
    Check the requirement

    Yoast SEO active.

  3. 03
    Connect 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.

  4. 04
    Ask 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.

Point your AI agent at Yoast SEO.