Connecting to the MCP Server

• Overview
• Prerequisites
• Enable the Gravity Forms MCP
• Create an Application Password
• Claude Desktop Setup
• Other AI Clients
• Testing Your Connection
• Verify Tools Are Available
• Try a Simple Prompt
• Troubleshooting

Overview

This article explains how to connect your AI assistant to Gravity Forms by enabling the MCP in WordPress, creating an Application Password, and configuring your AI client.

Prerequisites

WordPress 6.9 or higher with Gravity Forms installed and active.

Enable the Gravity Forms MCP

1. In WordPress, go to Forms → Settings → MCP.

2. Switch the toggle and save.

Create an Application Password

1. In WordPress, go to Users → Profile → Application Passwords.
2. Enter a recognizable name (e.g., “Claude MCP” or “Cursor MCP”).
3. Click Add New Application Password.
4. Copy the generated password. It is shown only once. Save it somewhere safe.

Note: Generate the Application Password from a dedicated user account with only the capabilities the MCP Server needs. Refer to Creating a User for MCP Access for more information.

Claude Desktop Setup

1. Download and install Claude Desktop.
2. Go to Settings → Developer.
3. Click Edit Config next to “Local MCP servers”.

4. Add the following configuration, replacing the values for “yoursite.com”, “your-username” and “your-api-password” with your own values:

{
    "mcpServers": {
        "gravityforms": {
            "command": "npx",
            "args": [
                "-y",
                "@automattic/mcp-wordpress-remote"
            ],
            "env": {
                "WP_API_URL": "https://yoursite.com/wp-json/mcp/gravityforms",
                "WP_API_USERNAME": "your-username",
                "WP_API_PASSWORD": "your-api-password",
                "OAUTH_ENABLED": "false"
            }
        }
    }
}

5. Save the file.
6. Quit and restart Claude Desktop.

Refer to the Claude official documentation for more information.

Other AI Clients

Most MCP-compatible AI clients use a JSON configuration file. Use the same configuration format as Claude Desktop above, adapting the file location to match your client:

• Cursor: Add to ~/.cursor/mcp.json or per-project .cursor/mcp.json
• Claude Code: Add to .mcp.json in your project directory or ~/.claude/mcp.json globally
• VS Code: Add to .vscode/mcp.json in your project workspace
• ChatGPT Business: ChatGPT is a cloud client, not a local one. It requires a dedicated endpoint and its own authentication setup. Refer to the Connecting ChatGPT Business to your Gravity Forms MCP article for more information.
• Other clients: Refer to your client’s MCP setup documentation for the configuration file location

Replace the same values (URL, username, password) for your site and user.

Testing Your Connection

Verify Tools Are Available

Start a new chat with your AI assistant and ask it to list available tools.

Try a Simple Prompt

Test the connection with a read-only operation:

• “List all my forms”

• “How many submissions does form 1 have?”
• “Get the details of form 2”

If the assistant responds with data from your site, the connection is working.

Troubleshooting

If you need further assistance, please contact our support team.