Connect CustomGForm to AI Agents via MCP

CustomGForm provides an official Model Context Protocol (MCP) server via native Streamable HTTP (2026-07-28 specification).

This enables your favorite AI agents and IDE assistants—including Claude, Codex, Antigravity, GitHub Copilot, and Cursor—to directly manage, customize, troubleshoot, and integrate your Google Forms using natural language.

What Can AI Agents Do With CustomGForm?

Once connected, your AI agents have access to 10 specialized tools:

Plan Limits & Feature Gating

Ask AI and MCP tools enforce the same plan allowances as the dashboard:

When an AI action exceeds your plan limits, tools return a structured upgradeRequired: true response with direct upgrade links:

• Dashboard Ask AI: Prompts an interactive Upgrade Plan card directing you to /dashboard/usege-and-plans.
• External MCP: Returns a direct link to https://customgform.com/dashboard/usege-and-plans so agents can instruct you on how to upgrade.

Step 1: Generate an MCP Access Token

Step 2: Configure Your AI Agent

Select your tool or agent below for specific setup instructions:

{
  "mcpServers": {
    "customgform": {
      "url": "https://customgform.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CUSTOMGFORM_API_TOKEN"
      }
    }
  }
}

claude mcp add customgform --url https://customgform.com/api/mcp --header "Authorization: Bearer YOUR_CUSTOMGFORM_API_TOKEN"

Step 3: Test Your Connection

Now you can speak to your AI agent naturally. Here are sample prompts to test:

1. Diagnose a Google Form

"Can you troubleshoot my Google Form connection? Link: https://docs.google.com/forms/d/e/1FAIpQLScQNAKF0rg3JtFFpAOTvQVsO7R5g9Hmcng_DpxqMKBxf7hsoQ/viewform"

The agent will run troubleshoot_form_connection and confirm if it is public or if Google sign-in settings need adjustments.

2. Import and Restyle a Form

"Import this Google Form into CustomGForm, apply a dark green minimal theme, change the submit button to 'Send Feedback', and enable submission redirect to https://example.com/thank-you"

The agent will call create_google_form followed by customize_google_form. CustomGForm's built-in Color Harmony Guardian automatically balances contrast ratios (WCAG 2.1 AA), cascades matching interactive accents, and ensures high legibility across light and dark surfaces.

3. Save Form Theme as Template

"Save the current theme of form [form_id] as a reusable template named 'Dark Emerald' with description 'Modern dark theme with emerald highlights'"

The agent will run save_theme_to_template. The template will immediately become available in your dashboard under Manual Configuration → Design → Templates to apply to any other form.

4. Add File Upload Addon

"On form [form_id], attach a file upload addon to the 'Resume' question allowing up to 3 PDF or Word documents, max 20MB."

The agent will find the question and run configure_field_addon. If allowed file formats, max size, or file count are omitted, the agent will ask for clarification first.

5. Get Share Link or Embed Code

"Give me a shareable link for form [form_id] with email prefilled as '[email protected]' and the company field hidden. Also give me the React component code with popup mode enabled."

The agent will run get_form_share_instructions and return the ready-to-share URL, HTML embed snippet, and React component code.

6. Analyze Form Conversion & Drop-off

"How is my form [form_id] performing this month? What is my completion rate and where are people dropping off? Can you also export a CSV report?"

The agent will run get_form_analytics (with optional format: 'csv') and report total impressions, engagement starts, completed submissions, completion rate, average completion time, wizard step drop-off points, and full CSV export data.

7. Search, Filter, and Export Responses

"Show me partial drop-off responses for form [form_id] where respondents dropped off before completing. Can you also give me the CSV?"

The agent will run get_form_responses (with status: 'partial') and return structured rows with drop-off progress, an interactive table preview, and a full CSV export.

Audit & Activity Tracking

Every tool call executed by external AI agents is logged in your CustomGForm account for full transparency.

1. Go to Settings.
2. Click Activity Log.
3. View timestamps, tool names, execution status, input parameters, and origin badges:
   • UI Chat: Initiated directly from the internal dashboard chat.
   • MCP: <TokenName>: Initiated externally from your configured agent (e.g., MCP: Claude Desktop, MCP: Antigravity).

You can revoke an API token at any time by clicking the trash icon in your tokens table. Revoked tokens immediately lose all access.