Gravity Forms MCP · Pro
Gravity Forms MCP: forms, notifications and entries for your AI agent.
A Gravity Forms MCP server lets an AI agent read what your forms collect and how they are wired: fields, notifications, confirmations, entries and notes. WP MCP goes through Gravity Forms' public API, and every write it offers is snapshotted first and reversible.
Self-hosted · snapshot before every write · one-click undo
› Mark the obvious spam on the Contact form as spam
gravityforms-read list-entries, form 1, status active
⛨ before-image of each entry row
gravityforms-write update-entry-status, spam
✓ 9 entries moved to spam. Each one is restorable.
What it is
What a Gravity Forms MCP server does.
Gravity Forms keeps forms and submissions in its own tables, reached through the public GFAPI. That data answers real business questions: how many quote requests came in, what people keep asking for, who gets notified when. A Gravity Forms MCP server lets an agent ask those questions directly.
WP MCP is conservative about writes here. Submissions are personal data, so entry operations sit behind manage_options. Moving an entry between active, spam and trash works the way Gravity Forms' own entry screen does. Editing notifications and confirmations and deleting an entry stay off until the site opts in, and the riskier ones ask for confirm:true.
Gravity Forms sites usually accumulate forms with conditional notifications, and the first thing anyone needs is to see how they are wired. WP MCP reads forms, fields, notifications, entries and notes through the public GFAPI, which is why any licence level works. Its default write is an entry status move between active, spam and trash. Notification and confirmation edits and entry deletes are there too, off until the site opts in, and every write is snapshotted. Entry operations require manage_options.
Read and change
What WP MCP can read and change in Gravity Forms.
It can read
- Forms, with entry counts and field counts
- A form's fields, notifications and confirmations
- Entries, newest first, filtered by status and paged
- A single entry with all its field values and notes
It can change
- Move an entry between active, spam and trash
- Edit a notification's subject, message, sender, reply-to, name or enabled state (opt-in)
- Change a notification's to and bcc recipients (opt-in, needs confirm:true)
- Edit a confirmation's type, message, page or redirect url (opt-in, needs confirm:true)
- Delete an entry with its values and notes (opt-in, needs confirm:true, restorable)
These are the real ability and operation names the agent calls. TheGravity Forms AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
How many entries did the Contact form get this month, and what are the common themes?
Show me who the Quote Request form notifies, and under which conditions.
Read entry 512 with its notes and draft a reply.
How many entries did the Contact form get this month, and what are the common themes?
list-entries pages through entries by status, newest first, and the agent summarises them.
Show me who the Quote Request form notifies, and under which conditions.
gravityforms-read returns the form's notifications, so the routing is visible without opening the form editor.
Mark the obvious spam on the Contact form as spam.
update-entry-status moves each entry to spam after a before-image of that entry row, and rollback-operation puts it back.
Safety
Every Gravity Forms write has a way back.
The status move is snapshotted as a before-image of exactly that entry row, so rollback-operation puts the entry back where it was. A notification or confirmation edit snapshots the form's gf_form_meta row, and rollback-operation restores it. A delete snapshots every gf_entry, gf_entry_meta and gf_entry_notes row it removes, and rollback-session puts them back. Uploaded files stay on disk.
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.
Deletes are opt-in and confirmed
Deleting an entry is off until the site opts in, needs confirm:true, and is refused with entry_has_payments when the entry has a payment.
Free or Pro
Part of WP MCP Pro.
Gravity Forms support is part of the WP MCP Pro forms pack, alongside WPForms, Formidable, Ninja Forms and Fluent Forms. It uses the standard GFAPI, so any Gravity Forms license level works. Contact Form 7 support is in the free plugin.
WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.
How to connect
Connect Gravity Forms 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
Gravity Forms active, any license level. Notification, confirmation and delete writes are off until the site enables them with the wpmcp_enable_forms_write filter.
- 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 Gravity Forms. 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
Gravity Forms MCP: questions, answered.
What is Gravity Forms MCP?
It is Gravity Forms data made available to AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client read forms, fields, notifications, confirmations and entries, move entries between statuses, and, once the site opts in, edit notifications and confirmations or delete entries.
Can the agent delete entries?
Yes, after the site opts in with the wpmcp_enable_forms_write filter, and only with confirm:true. Gravity Forms' gform_delete_entry action does not run and uploaded files stay on disk. Every row is snapshotted first, so rollback-session restores the entry, and a copy stays in the snapshot history until it is pruned: this is not a privacy erasure.
Can it create or edit forms?
It cannot create forms or change their fields. After the opt-in it can edit notifications, their recipients and confirmations, each undone with rollback-operation.
Which Gravity Forms license do I need?
Any. WP MCP uses the standard GFAPI that every Gravity Forms license includes.
Is Gravity Forms MCP free?
It is part of the WP MCP Pro forms pack. The free plugin includes Contact Form 7 support.
Does it work with any Gravity Forms licence?
Yes. It uses the standard GFAPI, so the licence level does not matter. The integration itself is part of the WP MCP Pro forms pack.
Can the agent edit my forms?
Not the forms or their fields. Once the site opts in with the wpmcp_enable_forms_write filter, it can edit notifications, their recipients and confirmations (each undone with rollback-operation), and delete an entry with confirm:true (restored with rollback-session).
Does Gravity Forms 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 Gravity Forms tools are available in every client the same way.
Keep exploring
MCP for Gravity Forms →
Read Gravity Forms forms, fields, notifications, confirmations and entries over MCP, move entries between active, spam and trash, and edit notifications or delete entries on opt-in, undoably.
Read and triage Gravity Forms submissions with your AI agent →
Connect Claude or Cursor to WP MCP Pro and have it list forms, read fields and notifications, triage Gravity Forms entries, and mark spam, every status change undoable.
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.
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.
FunnelKit MCP →
A FunnelKit MCP server lets an AI agent see how your funnels are put together and change them on request.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.