Documentation » Getting Started
Connect an AI Agent to Groundhogg
Overview
You can connect an AI agent like ChatGPT, Claude or Gemini to Groundhogg and ask it to work in your CRM in plain language. It can build and edit flows, write and schedule emails, find and update contacts, and pull reports, using the same tools Groundhogg uses itself.
This guide covers getting connected and using an agent safely. If you’re a developer looking for the full list of abilities or want to set things up by hand, see Working with the Abilities API (MCP). Once you’re connected, you can also start from the AI cards in Groundhogg, see Build and Edit with AI.
What You’ll Need
- Groundhogg 4.11 or later.
- WordPress 6.9 or later.
- A WordPress user who can view contacts. Anyone who can view contacts can connect their own agent.
- An administrator, or anyone who can install and activate plugins, to set up the MCP Adapter plugin the first time.
- An AI client that supports MCP connectors, such as ChatGPT, Claude, Codex, Cursor, Gemini CLI or VS Code.
Connecting Your Agent
Go to Groundhogg » Tools and open the AI agent tab. You’ll also find it recommended on the Groundhogg dashboard and in the last step of the guided setup. The tab takes you through three steps, one at a time.
1. Get your site ready
Agents talk to your site through the official MCP Adapter plugin from WordPress.org. Click Install and activate the MCP Adapter, or Activate the MCP Adapter if it’s already installed, and Groundhogg does it for you. You only do this once for the whole site.
If you can’t install plugins, you’ll see that an administrator needs to install and activate the MCP Adapter first. Ask one who can, then come back to the tab.

2. Create a password for your assistant
- Under Name it so you can tell it apart later, give the password a name, like the name of your agent.
- Click Create password.
This is an application password, what the agent signs in with. It’s separate from your real password, and you can revoke it at any time. The agent signs in as you, so it can do what you can do on your site and nothing more. Only connect agents you trust.

❗ Application passwords need a secure (HTTPS) connection. If your site doesn’t have one, or another plugin has turned them off, the tab tells you they aren’t available.
3. Connect your assistant
- Under Which assistant do you use?, choose yours: ChatGPT or Claude app, Claude Code, Codex, Cursor, Gemini CLI, VS Code or Something else.
- Follow the steps shown for it. Your password is already filled in.
- Restart your agent if it doesn’t pick up the connection, then ask it: “What can you do with my site?”

❗ The password won’t be shown again, so finish setting up your agent before you leave the page. If you do leave, click Create a new password to have the details filled in again.
Something else is for agents that only run local programs, like Windsurf and Zed. It uses a small helper that needs Node.js installed.
Using the ChatGPT or Claude app?
Not every app or plan allows the custom header the password needs. There’s an easier way: the free Enable Abilities for MCP plugin from WordPress.org lets those apps sign in with a login and approval screen, so there’s no password to copy. It also adds abilities for the rest of WordPress.
- In step 3, click Install and activate Enable Abilities for MCP.
- Click Open its settings to turn on sign-in and turn it on.
- In the app, add your site as a custom connector, then sign in and approve it.
It’s optional. The password steps and the other options keep working either way. Enable Abilities for MCP needs PHP 8.0 or later.
Things to Try
Describe what you want the way you’d ask a teammate. A few examples:
- “Build a welcome flow for new subscribers: send a welcome email, wait 2 days, then send our getting started guide.”
- “Look at my onboarding flow and add a 2 day delay before the second email. Simulate it for a test contact before publishing.”
- “Write a newsletter about our holiday hours and schedule it for Monday at 9 AM to everyone tagged Customers.”
- “Find contacts who opened an email last month but haven’t visited the pricing page.”
- “How did last week’s broadcast do? Compare its open and click rates to the one before.”
- “What’s left to set up on my site?”
Not sure what it can do? Ask “What can you do in my Groundhogg CRM?” and it will list everything available on your site, including abilities added by your add-ons. It can also look up how-to answers in the Groundhogg documentation for you.
Want to see it in action first? Watch Claude build a flow, edit a live one and fix reports.
Using an Agent Safely
An agent works with real data and can take real actions, so it’s worth knowing where the guardrails are.
- It has your permissions, nothing more. Every action goes through the same permission checks as the rest of Groundhogg. To limit what an agent can do, connect it as a WordPress user with a more limited role, such as a marketer or sales rep, instead of an administrator. See User Roles & Capabilities and Contact Personal Information Access.
- Changes to live flows are staged. When an agent edits an active flow, nothing changes for your contacts until the changes are published, and they can be discarded instead. New flows are always created inactive.
- Simulate before you go live. Ask the agent to simulate a flow for a test contact. A simulation shows which path the contact would take with no side effects. A live simulation is different: it really runs the steps and really sends emails, so only use it with a test contact.
- One-off emails skip consent checks. Broadcasts and saved emails only go to contacts who can be marketed to. A one-off composed email is meant for one-to-one messages and doesn’t check marketing consent, so don’t ask an agent to use it for bulk sending.
- Review before it sends. For emails and broadcasts, ask the agent to save a draft first so you can preview it in Groundhogg before anything is scheduled. It can also send a test of a draft to you.
- Never paste secrets into the chat. Enter passwords and API keys in your site yourself. The guide Groundhogg gives your agent tells it not to ask for them.
Disconnecting an Agent
An agent connects with an application password, which works like a password for your WordPress account. To disconnect an agent, go to Users » Profile, find its application password under Application Passwords and click Revoke. Revoke it right away if you think it may have been shared or exposed.
FAQs / Troubleshooting
Q: I can’t find the AI agent tab.
A: Check that your site is on WordPress 6.9 or later and Groundhogg 4.11 or later, and that your user can view contacts.
Q: The tab says application passwords aren’t available.
A: WordPress only allows them over a secure (HTTPS) connection, and another plugin may have turned them off. Add SSL to your site, or use Enable Abilities for MCP with the ChatGPT or Claude app.
Q: My agent doesn’t see any Groundhogg tools.
A: Restart your agent so it picks up the connection, and check that the MCP Adapter is still active in Plugins. If you created a new password, update it in your agent too.
Using Claude? We have free skills that teach Claude the right way to build Groundhogg block emails and design flows. Download them from the Abilities API doc.