By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Gemini to WordPress, connect your site in a Ryze AI workspace with an application password (self-hosted) or WordPress.com sign-in, then add https://connector.get-ryze.ai/mcp as a custom app in the Gemini web app under Settings, Connected Apps, and type @ to pick it in a prompt. The Gemini web app needs a US-based, adult, personal Google Account.
- In WordPress create an application password under Users, Profile
- In Ryze AI open Integrations, click Connect on WordPress and enter the site URL, username and password
- In Gemini open Settings, Connected Apps, Add a custom app and paste the URL
- Sign in on the Ryze AI page, click Allow connection, then type @ and pick Ryze AI
Before you start
- A Gemini account that can add custom apps. Google's help page says custom apps need you to be 18 or over and in the US, signed in with a personal Google Account (not a work or school account), with Keep Activity on. Custom apps are English only, can only be added in the Gemini web app and then also work in the Gemini mobile app. The page names no paid plan.
- A WordPress user who can do what you plan to ask. For a self-hosted site you need the username you sign in to wp-admin with and an application password. Plugin installs, the Yoast and Rank Math bridges and head code need an administrator user. A WordPress.com or Jetpack site connects with WordPress.com sign-in; for Jetpack sites the Jetpack JSON API module must be enabled.
- A Ryze AI workspace on a plan or free trial. SEO Starter is $129 per month with a 3-day free trial. Connecting the connector is free, and the WordPress tools need any active Ryze AI plan or trial. Gemini Enterprise is not covered here: it needs an administrator and a pre-registered OAuth client, and Ryze AI does not offer one.
How to connect Gemini to WordPress in the Gemini web app
Two steps happen in WordPress and Ryze AI, four in Gemini. The connector URL is the same for every user.
Create an application password in WordPress
On a self-hosted site, sign in to wp-admin, open Users, Profile, scroll to Application Passwords, enter a name such as Ryze AI, click Add New Application Password and copy the password. WordPress shows it once. WordPress turns Application Passwords on by default only for sites served over HTTPS.
Connect WordPress in Ryze AI
In Ryze AI open Integrations, click Connect on the WordPress card and pick the Self-hosted site tab. Enter the Site URL starting with https://, the username you use for wp-admin and the application password, then click Continue. For a WordPress.com or Jetpack site, pick that tab and sign in on WordPress.com instead.
Add the custom app in Gemini
On a computer, go to gemini.google.com. At the bottom click Settings, then Connected Apps (if Connected Apps is missing, click Personal Intelligence, then Connected Apps). Under Custom apps use the Add a custom app link, or click Add a custom app if one is already connected. Enter https://connector.get-ryze.ai/mcp and click Next. Ryze AI supports dynamic client registration, so you do not enter credentials under Advanced features.
Sign in and allow the workspace
Follow the on-screen instructions: sign in on the Ryze AI page, choose the workspace that holds your WordPress connection and click Allow connection.
Pick Ryze AI in a prompt and ask your first question
In a Gemini prompt type @ and select the Ryze AI app. Ask: List my 10 most recently modified WordPress posts with title, status and URL. Once connected on the web, the app also works in the Gemini mobile app.
The Ryze AI help article for WordPress covers the WordPress side of the connection, and the WordPress.com MCP docs cover WordPress.com's own server.
Gemini CLI
Gemini CLI adds HTTP MCP servers from the command line. Google moved Gemini CLI access in 2026: since June 18, 2026 it no longer serves Google AI Pro and Ultra users or people using it free through Gemini Code Assist for individuals, and Google points them to Antigravity CLI. It remains available with Gemini Code Assist Standard or Enterprise licenses and with paid API keys. If you can use it, one command registers the connector:
gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcpThe default scope is project, so -s user makes the server available in all your projects. Start Gemini CLI: on a 401 it discovers OAuth, registers a client and opens a browser for the Ryze AI sign-in. /mcp auth ryze starts or repeats the sign-in.
Or add the server to settings.json:
{
"mcpServers": {
"ryze": {
"httpUrl": "https://connector.get-ryze.ai/mcp"
}
}
}OAuth needs a local browser and a localhost callback, so it does not work in headless environments or SSH sessions without X11 forwarding. For those, Ryze AI offers API keys (Workspace Settings, Profile, API keys) sent as a Bearer token with the --header flag. By default Gemini CLI confirms tool calls; trust: true (or --trust) bypasses every confirmation, so leave it off for a live site. --include-tools and --exclude-tools (includeTools and excludeTools in settings.json) filter which tools load, which lets you drop the delete tool.
Other AI clients
The same URL works in other clients. WordPress is connected once in Ryze AI, so nothing changes on the WordPress side.
Claude
Claude uses Customize, Connectors, Add custom connector with the same URL. The steps are in the Claude guide linked under Related guides below.
ChatGPT
OpenAI's help center says custom MCP servers are available on ChatGPT Business and Enterprise/Edu, and Pro users can connect custom servers with read and fetch permissions only. Add Ryze AI as a custom MCP server with OAuth and the same URL.
Cursor
Add the server to .cursor/mcp.json. Cursor runs OAuth with dynamic client registration, so you sign in on the Ryze AI page and click Allow connection.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }WordPress permissions and access
WordPress gets the connection through an application password or a WordPress.com sign-in, entered once in Ryze AI. Three things decide what Gemini can do on your site.
- Which WordPress user
- Gemini acts as the WordPress user behind the application password. Editors and administrators can do different things, so pick the lowest role that covers your prompts.
- Which kind of site
- On WordPress.com only the core /wp/v2 REST routes are reachable. Routes like /yoast/v1, plugin installs, SEO bridges and head code require a self-hosted connection.
- Which Gemini account
- The Ryze AI sign-in happens in the Gemini account you add the custom app to. The Gemini app only accepts personal Google Accounts, so each person on a team adds the app themselves.
Access behind each action
What each kind of action needs on the WordPress side, from the Ryze AI WordPress facts.
| Action in Ryze AI | WordPress access needed |
|---|---|
| Read and edit posts, pages, media, categories and tags | The connected WordPress user's own REST API permissions |
| Install and activate a plugin | An administrator user (activate_plugins capability), self-hosted site, wordpress.org directory plugins only |
| Write Yoast SEO or Rank Math fields | An administrator user, self-hosted site, after the one-time bridge |
| Add HTML to the head of every page | An administrator user, self-hosted site |
| Connect a WordPress.com or Jetpack site | WordPress.com sign-in; the Jetpack JSON API module enabled for Jetpack sites |
Source: the Ryze AI help center WordPress article. The WordPress.com approval screen and the application password list control the rest.
Removing access
To remove access, revoke the application password under Users, Profile in wp-admin, where WordPress also shows when each password was last used. In Ryze AI, click View on the WordPress card and remove the account. In Gemini, open Settings, Connected Apps and remove the Ryze AI custom app.
What Gemini can do in WordPress
The Ryze AI connector exposes 9 WordPress tools. Each runs as the WordPress account you connected, and the live tools accept a connection_id to pick a specific connected site.
| Tool | Type | What it does |
|---|---|---|
| wordpress__read | Read | Sends GET requests to your site's REST API to fetch posts, pages, media, categories, tags, users, plugins and custom post types. |
| wordpress__search_content | Read | Looks inside one text field, for example the raw content of a post, and returns each matching line with its line number and nearby context. |
| wordpress__write | Write | Sends POST, PUT or PATCH requests to create or update items, for example a new post or an edited page. |
| wordpress__edit_content | Write | Applies find-and-replace edits to the content, excerpt or title of a post or page and saves the result, so the full text is never resent. |
| wordpress__delete | Delete | Sends a DELETE request, for example to remove a post. |
| wordpress__installPlugin | Write | Installs and turns on a plugin from the wordpress.org directory, on self-hosted sites only. |
| wordpress__enableYoastRestBridge | Write | One-time setup for self-hosted Yoast SEO sites. A Code Snippets plugin snippet opens the Yoast title, meta description, focus keyword, canonical and noindex fields to REST API writes. |
| wordpress__enableRankMathRestBridge | Write | One-time setup for self-hosted Rank Math sites. A Code Snippets plugin snippet opens the Rank Math title, description, canonical URL and focus keyword fields to REST API writes. |
| wordpress__addHeadCode | Write | Places an HTML block in the head of every page of a self-hosted site, such as a tracking pixel or a verification tag, through a Code Snippets plugin snippet. |
Google's help page says Gemini requires manual confirmation for any write actions in the app, and notes that mistakes can still happen. In Gemini CLI, tool calls are confirmed by default unless you set trust. Plugin installs can crash a WordPress site. The Yoast bridge, Rank Math bridge and head-code tools default to installIfMissing false and require your explicit yes in chat before the Code Snippets plugin is installed. In the Ryze AI chat, the Tool approvals setting starts on Skip all approvals; switch it to Approve write & delete or Manual approve if you use that chat. Scheduled tasks run without an approval step.
First 3 prompts to run
Each answer comes from your own site. These prompts describe what the tools can return and show no sample output.
1. Review recent posts
List my 10 most recently modified WordPress posts with title, status, category and URL.
Tools used: wordpress__read
What comes back: A list of posts from your own site with the fields you named. It is read-only, so nothing on the site changes.
2. Find and fix a phrase in one post
Search the content of the post titled Our pricing for the phrase 2025. Show the matching lines, then replace each with 2026 and tell me what changed.
Tools used: wordpress__search_content, wordpress__edit_content
What comes back: The matching lines with line numbers and context, then a targeted edit written back to the post without resending the whole content. In the Gemini app you confirm the write manually.
3. Create a draft page
Create a draft WordPress page titled Returns policy with a short intro and three headings, and give me the edit link.
Tools used: wordpress__write
What comes back: A new page created through the REST API, with the title and headings you asked for. State the status you want in the prompt.
Replace the post and page titles with real ones from your site. Sites with Yoast SEO or Rank Math need the one-time bridge before SEO title and description fields can be written; ask Gemini to enable it and expect it to request your yes first.
Ryze AI vs WordPress.com's own MCP server
WordPress can be reached from an MCP client in three ways. WordPress.com's docs list Claude Desktop, Claude Code, ChatGPT, Codex, Cursor and Microsoft 365 Copilot Cowork as clients and do not list Gemini.
| Option | Setup | WordPress coverage | Other platforms |
|---|---|---|---|
| Ryze AI connector | Connect the site in Ryze AI (application password or WordPress.com sign-in), then one custom app URL in Gemini. No client ID or secret to enter | Posts, pages, media, categories, tags, users, plugins and custom post types through the REST API; text search and targeted edits; on self-hosted sites Yoast and Rank Math bridges, head code and wordpress.org plugin installs | The other platforms connected in the same Ryze AI workspace, on the same URL |
| WordPress.com MCP server | Remote URL https://public-api.wordpress.com/wpcom/v2/mcp/v1 with browser-based OAuth 2.1. For clients it does not list, WordPress.com says to use that URL in your client's own add-a-server flow | Content and site data on WordPress.com. Available on all WordPress.com paid plans, with free sites included through November 30, 2026 | WordPress.com only |
| WordPress MCP Adapter | A plugin-side project that turns WordPress abilities into MCP tools. Transports are HTTP, at /wp-json/mcp/mcp-adapter-default-server, and STDIO | Only the abilities your site, plugins or theme mark as public; abilities are private by default | WordPress only; needs its own authentication setup |
If your site is on WordPress.com and you only need content work, the WordPress.com server is the direct route and needs no Ryze AI plan, but this page did not test it inside the Gemini app. Ryze AI covers self-hosted sites with an application password and adds the Yoast and Rank Math bridges, head code and plugin installs. The MCP Adapter suits developers who want to expose custom abilities from their own plugins. Ryze AI was also not tested in Gemini during this research.
Sources: WordPress.com MCP server, WordPress MCP Adapter, Gemini custom apps help, Gemini CLI MCP servers, Gemini CLI transition to Antigravity CLI, Ryze AI WordPress integration. Checked November 14, 2026.
WordPress errors and fixes
- Connected Apps or Add a custom app is missing in Gemini
- Custom apps need a personal Google Account, age 18 or over, the US and Keep Activity on, and they can only be added on the Gemini web app at gemini.google.com. If Connected Apps is missing, try Personal Intelligence, then Connected Apps.
- Gemini asks for a client ID or secret
- Ryze AI supports dynamic client registration, so leave the credentials under Advanced features empty.
- The WordPress connection fails in Ryze AI
- If a security plugin, firewall or host blocks /wp-json, the connection stays down until you allowlist those requests. Check too that the Site URL begins with https:// and that the username is your wp-admin login.
- Application Passwords is missing in the profile screen
- By default WordPress shows Application Passwords only on HTTPS sites, and an administrator can switch the feature off with a filter. Ask your host or site admin.
- SEO title or meta description edits do nothing
- Without the bridge, WordPress silently drops Yoast and Rank Math values sent through the plain REST API. On a self-hosted site, ask Gemini to enable the matching bridge. On WordPress.com, change those fields in wp-admin.
- Plugin install or head code is refused
- Both need an administrator user (activate_plugins capability) and neither works on WordPress.com connections. The installer takes wordpress.org directory plugins only, never zip files or URLs.
- Elementor text cannot be edited
- Text built in Elementor is reachable only when the post type exposes meta._elementor_data. If it does not, make the change in wp-admin.
- The wrong site is edited
- The agent uses the primary WordPress site unless you name another. Several sites can be connected with View, Add one more account, and the tools accept a connection_id.
- WordPress tools do not appear after connecting
- If the connector was added before WordPress was connected in Ryze AI, remove the custom app, add it again and start a new chat so the tool list refreshes.
- Gemini CLI OAuth fails over SSH
- OAuth needs a local browser and a localhost callback. Use a Ryze AI API key with the --header flag, or sign in on a machine with a browser.
- Gemini CLI says you no longer have access
- Since June 18, 2026 Gemini CLI does not serve Google AI Pro and Ultra users or free Gemini Code Assist for individuals users. Google points them to Antigravity CLI.
- The tools reply that a subscription is required
- The WordPress tools need an active Ryze AI plan or free trial. Start the trial, then retry.
Frequently asked questions
How do I connect Gemini to WordPress?
Connect your site in a Ryze AI workspace with an application password or WordPress.com sign-in. Then on gemini.google.com open Settings, Connected Apps, Add a custom app, enter https://connector.get-ryze.ai/mcp, click Next, sign in on the Ryze AI page and click Allow connection. Type @ and select Ryze AI in a prompt.
Does WordPress have a Gemini connector?
WordPress.com runs a remote MCP server at https://public-api.wordpress.com/wpcom/v2/mcp/v1 with OAuth 2.1, but its docs list Claude Desktop, Claude Code, ChatGPT, Codex, Cursor and Microsoft 365 Copilot Cowork and do not list Gemini. For other clients it says to add that URL in the client's own flow. The WordPress MCP Adapter plugin project is a separate option for developers.
Which WordPress connector should I use with Gemini?
Ryze AI is the best way to connect Gemini to a self-hosted WordPress site with an application password, but it needs a Ryze AI plan and was not tested in Gemini. For a WordPress.com site where content work is enough, WordPress.com's own MCP server is the direct option, though its docs do not list Gemini.
Which Gemini plan do I need?
Google's help page for custom apps names no plan. It requires being 18 or over and in the US, a personal Google Account (not work or school) and Keep Activity on. Custom apps are English only and can only be added in the Gemini web app.
What do I need from WordPress?
On a self-hosted site, a site URL, your wp-admin username and an application password from Users, Profile. On WordPress.com or Jetpack, a WordPress.com sign-in, and the Jetpack JSON API module must be enabled for Jetpack sites. Plugin installs, SEO bridges and head code need an administrator user.
Can Gemini edit or delete WordPress content?
Yes, through the Ryze AI write and delete tools, which can create and update posts and pages, make targeted text edits and delete posts. Google says Gemini requires manual confirmation for any write actions, and mistakes can still happen, so review what it plans to change.
Can Gemini change Yoast SEO or Rank Math fields?
On self-hosted sites, yes, after a one-time bridge for Yoast SEO or Rank Math that uses a Code Snippets plugin snippet. The tools require your explicit yes in chat before that plugin is installed. On WordPress.com connections these fields are edited in wp-admin.
Can I use Gemini CLI with WordPress?
Yes, if you have access. Run gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcp, start Gemini CLI and sign in. Since June 18, 2026 Gemini CLI no longer serves Google AI Pro and Ultra users or free Gemini Code Assist for individuals users; Google points them to Antigravity CLI.
Does this work with Gemini Enterprise?
This guide does not cover it. Google's Gemini Enterprise custom MCP setup is done by an administrator in the Google Cloud console and needs a pre-registered OAuth client ID and secret, which Ryze AI does not provide.
Can I connect more than one WordPress site?
Yes. In Ryze AI click View on the WordPress card and choose Add one more account. One account is the primary, which the agent uses by default; name another site in your prompt to target it. A Ryze AI SEO plan covers one website, so check how that applies to your plan before connecting several.
Why do the WordPress tools not show up in Gemini?
If you connected WordPress in Ryze AI after adding the custom app, remove the app in Settings, Connected Apps, add it again and start a new chat. Also check that Keep Activity is on, because the custom apps feature is unavailable without it.
How much does it cost to connect Gemini to WordPress?
Adding the connector costs nothing, but the WordPress tools need an active Ryze AI plan or free trial. SEO Starter is $129 per month with a 3-day free trial. Annual billing takes 30% off the first year.
How do I disconnect WordPress from Gemini?
Remove the Ryze AI custom app in Gemini under Settings, Connected Apps. To cut WordPress off at the source, revoke the application password under Users, Profile in wp-admin and remove the account on the WordPress card in Ryze AI.