Get the plugin
WP MCP/Integrations/Gravity Forms MCP

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

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)
gravityforms-readgravityforms-writelist-entriesupdate-entry-statusupdate-notificationdelete-entry

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.

  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

    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.

  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 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.

Point your AI agent at Gravity Forms.