Connect CustomGForm to AI Agents via MCPCopy Anchor Link

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?Copy Anchor Link

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

Plan Limits & Feature GatingCopy Anchor Link

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 TokenCopy Anchor Link

Step 2: Configure Your AI AgentCopy Anchor Link

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 ConnectionCopy Anchor Link

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

1. Diagnose a Google FormCopy Anchor Link

"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 FormCopy Anchor Link

"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 TemplateCopy Anchor Link

"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 AddonCopy Anchor Link

"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. Add E-Signature AddonCopy Anchor Link

"On form [form_id], turn the 'Authorized Signature' question into an e-signature drawing pad with Google Sheets =IMAGE() rendering enabled."

The agent will find the question and run configure_field_addon with addonType: 'signature' and signatureConfig: { insertAsImageFormula: true, requireConsent: true }.

6. Add a Barcode or QR Code ScannerCopy Anchor Link

"On form [form_id], turn the 'Asset tag' question into a barcode scanner that auto-submits after each scan."

The agent will find the question and run configure_field_addon with addonType: 'barcode' and scannerConfig: { autoSubmit: true, allowManualEntry: true }. Use addonType: 'qr-code' for QR codes. Only Short Answer questions are supported, and the addons require a Starter or Pro plan. Learn more in the QR code scanner and Barcode scanner guides.

6. Get Share Link or Embed CodeCopy Anchor Link

"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, high-resolution QR code data URL, HTML embed snippet, and React component code.

For a floating icon launcher, ask for popover mode:

"Give me embed code for form [form_id] as a bottom-left popover with the help icon and a green background."

The agent runs get_form_share_instructions with mode: 'popover' and optional popoverIcon (chat, feedback, help, mail, form, star), popoverIconSvg (custom <svg> markup, sanitized, max 20KB), popoverPosition (bottom-right, bottom-left, inline), popoverTooltip (attention bubble text, max 120 chars), popoverBackground, popoverIconColor, popoverSize and popoverRounded.

6. Analyze Form Conversion & Drop-offCopy Anchor Link

"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 ResponsesCopy Anchor Link

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

8. Manage Account Timezone & Date FormatsCopy Anchor Link

"What is my current timezone? Can you update it to 'America/New_York' so my response tables display in Eastern Time?"

The agent will run update_user_timezone (with timezone: 'America/New_York') and confirm the active timezone along with 12-hour/24-hour display format.

Audit & Activity TrackingCopy Anchor Link

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.