Yoast SEO MCP: Edit Yoast Meta With AI (2026 Guide)
Table of Contents
Yoast SEO is the most-installed SEO plugin on WordPress, and for most editors the workflow is the same: write a post, scroll to the Yoast meta box, and hand-craft an SEO title and meta description for every single page. Doing it well across hundreds of posts is slow, repetitive work — exactly the kind of task an AI assistant should handle.
A Yoast SEO MCP connection makes that possible. It lets AI assistants like Claude read your existing Yoast metadata and write new SEO titles and descriptions directly into your posts — through conversation, not the meta box.
This guide explains what a Yoast SEO MCP connection is, what it can do, an important limitation of the native Yoast REST API, and how WordPress site owners can connect Yoast to Claude using Easy MCP AI.
What Is a Yoast SEO MCP Connection?
A Yoast SEO MCP connection exposes your Yoast SEO data to AI clients through the Model Context Protocol — an open standard Anthropic released on November 25, 2024, and donated to the Linux Foundation’s Agentic AI Foundation on December 9, 2025. Once connected, an MCP-capable AI client like Claude, Cursor, or ChatGPT can read and update the SEO metadata Yoast manages for each post and page.
As of this writing, there is no known official Yoast MCP server from Yoast. Instead, MCP access to Yoast data comes through WordPress MCP plugins that wrap Yoast’s stored metadata and the WordPress REST API.
The Native Yoast REST API Limitation
This is the key detail most guides miss: the Yoast SEO REST API is read-only. When Yoast is active, it adds yoast_head and yoast_head_json fields to REST API responses — a prefabricated blob of meta tags and schema for headless front-ends. But the native API does not support POST or PUT calls to update SEO data. Yoast also does not register its meta fields for REST write access by default; doing so manually requires a PHP snippet calling register_post_meta with show_in_rest for each field.
This means a generic REST integration can read Yoast SEO but cannot write it without custom code. A purpose-built MCP integration solves that by exposing structured read and write tools.
What a Yoast SEO MCP Connection Can Do
A complete Yoast MCP integration provides three core capabilities:
- Read SEO metadata — retrieve the current SEO title, meta description, focus keyword, and other Yoast fields for any post or page
- Write SEO metadata — set or rewrite the SEO title and meta description directly on a post
- Read the rendered head — fetch the full
yoast_headoutput (meta tags + schema) for a URL, useful for auditing what Yoast actually renders
Combined, these let an AI audit your current SEO, identify weak or missing meta descriptions, and write optimized replacements at scale.
Connect Yoast SEO to Claude via Easy MCP AI
For WordPress site owners, Easy MCP AI is the simplest way to connect Yoast to Claude. Easy MCP AI is a free, open-source WordPress plugin that turns your site into a fully compliant remote MCP server. Yoast SEO is one of three SEO plugins it supports natively — alongside Rank Math and All in One SEO.
What Easy MCP AI’s Yoast Tools Can Do
Easy MCP AI exposes 3 Yoast SEO tools as part of its full suite of 204 tools:
- Get post SEO — read the current Yoast SEO title, meta description, and focus keyword for a post
- Update post SEO — write a new SEO title and meta description directly to a post (the write capability the native Yoast REST API lacks)
- Get head — retrieve the rendered
yoast_headmeta-tag and schema output for a URL
Because Easy MCP AI runs on your own WordPress server, it handles Yoast metadata writes directly through wp_yoast_update_post_seo with full permission checks.
All credentials and operations stay on your own WordPress server, encrypted AES-256-GCM with per-provider HKDF-derived keys. Nothing is transmitted to any third party until Claude actively calls a tool.
Setup: Yoast + Claude via Easy MCP AI
Step 1 — Install Easy MCP AI. Install and activate Easy MCP AI from the WordPress plugin directory. It is free with no paid tiers or usage limits.
Step 2 — Activate Yoast in Easy MCP AI. Make sure Yoast SEO is installed on your site, then go to Easy MCP AI → Plugins and toggle Yoast SEO on to expose the Yoast tools to Claude.
Step 3 — Connect to Claude. Copy your MCP server URL from Easy MCP AI → Dashboard. In Claude, go to Settings → Connectors → Add custom connector, paste the URL, and authorize via OAuth.
Step 4 — Start optimizing. Open a Claude conversation and ask it to audit or rewrite your SEO metadata.
Example Prompts After Connecting
- “Read the Yoast SEO title and meta description for my post about espresso machines.”
- “Rewrite the meta description for that post to be under 155 characters and include the focus keyword.”
- “Which of my recent posts are missing a meta description? Draft one for each.”
- “Show me the rendered Yoast head output for my homepage.”
Yoast MCP vs. Editing in the Meta Box
| Yoast meta box (manual) | Yoast MCP connection | |
|---|---|---|
| Editing one post | Scroll to meta box, type, save | Ask in plain English |
| Bulk rewriting | Open each post individually | One prompt across many posts |
| Auditing gaps | Check each post by hand | Ask “which posts lack a meta description?” |
| Write access | Manual only | Direct write (native REST API is read-only) |
| Learning curve | Familiar but slow | Near zero |
Key Facts
- The native Yoast SEO REST API is read-only — it exposes
yoast_headandyoast_head_jsonbut does not support updating SEO data without custom code - As of this writing, there is no known official Yoast MCP server from Yoast; MCP access comes through WordPress MCP plugins
- Easy MCP AI exposes 3 Yoast tools (get post SEO, update post SEO, get head) and adds the write capability the native API lacks
- Easy MCP AI supports all three major SEO plugins — Yoast, Rank Math, and AIOSEO — through one MCP server
- Easy MCP AI is free and open source, with credentials encrypted AES-256-GCM on your own server
Conclusion
A Yoast SEO MCP connection turns SEO metadata from something you hand-edit in a meta box into something your AI assistant can audit and write at scale. Because the native Yoast REST API is read-only, a purpose-built integration is what makes AI-driven write access practical.
For WordPress site owners, Easy MCP AI connects Yoast — plus Rank Math, AIOSEO, and your full WordPress workflow — through a single MCP server, free and open-source.
→ Get Easy MCP AI from the WordPress plugin directory