# Run your forms from your AI

Connect Formidable to Claude, ChatGPT, Gemini, Copilot or another AI app once,
then just ask: what came in, build a form, tidy up spam, send leads to your CRM.

**Using a coding agent** (Claude Code, Cursor, Copilot, Codex, Gemini CLI)? Paste
this into it and it sets itself up:

```
Fetch and follow the instructions at https://staging.formidable.sh/agent-setup/prompt.md to connect Formidable to this agent.
```

## 1. Connect your AI app

The connector's address: `https://staging-api.formidable.sh/mcp`

### Claude

claude.ai and the Claude desktop app

1. **Open connector settings.** Open Settings, then Connectors, and click &quot;Add custom connector&quot;. On a Team or Enterprise plan, an owner adds it once for everyone under Organization settings, then Connectors.
2. **Add Formidable.** Name it Formidable, paste this address and click Add:

   ```
   https://staging-api.formidable.sh/mcp
   ```

3. **Connect and approve.** Click Connect next to Formidable. A Formidable page opens: sign in if asked, choose whether the app can use all your forms or only the ones you tick, and click Connect. You go straight back to the app.

### ChatGPT

chatgpt.com and the ChatGPT apps, on a paid plan

1. **Turn on developer mode.** Open Settings, then Apps &amp; Connectors (or Connectors), then Advanced settings, and switch on Developer mode - that is what allows custom connectors. Menu names can differ slightly between plans.
2. **Create the Formidable connector.** Back in Apps &amp; Connectors, click Create. Name it Formidable, paste this address, choose OAuth for authentication, tick that you trust it, and click Create:

   ```
   https://staging-api.formidable.sh/mcp
   ```

3. **Approve on Formidable.** A Formidable page opens: sign in if asked, choose whether the app can use all your forms or only the ones you tick, and click Connect. You go straight back to the app.
4. **Switch it on in a chat.** In a new chat, turn Formidable on from the tools menu (the + button). In developer mode it may be listed under Developer mode.

### Gemini

gemini.google.com and Gemini CLI

1. **Gemini app: add a custom connector.** On gemini.google.com, open Settings, then Connected apps (or Connectors), and add a custom app or connector. Name it Formidable and paste this address. Google is still rolling this out, so it may not be offered on every account or in every country yet, and menu names can differ:

   ```
   https://staging-api.formidable.sh/mcp
   ```

2. **Approve on Formidable.** A Formidable page opens: sign in if asked, choose whether the app can use all your forms or only the ones you tick, and click Connect. You go straight back to the app.
3. **Gemini CLI.** In a terminal, then run /mcp auth formidable inside Gemini CLI to sign in:

   ```
   gemini mcp add --transport http --scope user formidable https://staging-api.formidable.sh/mcp
   ```


### Copilot

GitHub Copilot in VS Code (agent mode)

1. **Add Formidable as an MCP server.** In VS Code, open the Command Palette and run &quot;MCP: Add Server&quot;. Choose HTTP, paste this address and name it formidable:

   ```
   https://staging-api.formidable.sh/mcp
   ```

2. **Sign in and approve.** When VS Code asks you to sign in to formidable, a Formidable page opens: sign in if asked, choose all your forms or only some, and click Connect.
3. **Use it in agent mode.** Open Copilot Chat, switch to Agent, and check the formidable tools are on in the tools menu. On Copilot Business or Enterprise, your organisation has to allow MCP servers.

### Cursor &amp; other apps

Cursor, Claude Code, Windsurf and other apps that support MCP

1. **Add a remote MCP server.** Look for &quot;MCP servers&quot;, &quot;Connectors&quot; or &quot;Tools&quot; in the app&#x27;s settings and add a server with this address (type: HTTP / Streamable HTTP):

   ```
   https://staging-api.formidable.sh/mcp
   ```

2. **Sign in and approve.** When the app asks you to sign in or authenticate, a Formidable page opens: sign in if asked, choose all your forms or only some, and click Connect.
3. **Example: Claude Code.** In a terminal, then run /mcp inside Claude Code to sign in:

   ```
   claude mcp add --transport http formidable https://staging-api.formidable.sh/mcp
   ```


## 2. Ask away

**See what came in**

- "What came in on my Contact form this week? Summarise anything that needs a reply today."
- "List the unread job applications with their names, emails and CV files."

**Build a form**

- "Make a quote request form with name, email, company, a budget dropdown and project details. Green brand colour, rounded corners. Give me the link."
- "Create an RSVP form for our 12 December party: name, number of guests, dietary needs. After sending, say &quot;See you there!&quot;."

**Tidy up**

- "Mark the obvious sales pitches on my Support form as spam."
- "Pause the workshop sign-up form, it&#x27;s full."

**Connect your tools**

- "Send new submissions from my Contact form to my Zapier webhook, then send a test."
- "Bring back the submissions I deleted from the Contact form yesterday."

## Good to know

- **It asks before big changes.** Before deleting a form or submissions, emptying the trash or pausing a form, your AI checks with you. Deleted submissions go to the trash first, so you can bring them back.
- **You stay in control.** The app only sees your forms - or just the ones you ticked when connecting. It can never reach your billing, account settings or anyone else&#x27;s forms.
- **Disconnect any time.** In Formidable, open the account menu, then API tokens, and revoke the &quot;(connector)&quot; token with your app&#x27;s name. It loses access straight away.
- **Your plan applies.** On the Free plan your AI can read your forms and submissions but not change them. Paid plans can also create and change forms, and add webhooks.
- **It&#x27;s people&#x27;s data.** Submissions hold other people&#x27;s personal details. The app sees what it asks for, so connect only apps you trust, and only the forms they need.
- **Forms for your own website.** Ask for HTML for your own site and your AI switches off the Formidable captcha on that form (it only works on our hosted pages and embeds). The built-in spam protection stays on.

## If something doesn't work

- **I can&#x27;t find &quot;Add custom connector&quot;.** Claude: on Team or Enterprise plans only an owner can add connectors, and the Free plan limits how many you can add. ChatGPT: custom connectors need a paid plan and Developer mode.
- **My AI doesn&#x27;t mention Formidable.** Start a new chat and check Formidable is switched on in the chat&#x27;s tools menu. After Formidable adds new features, disconnect and connect again so the app sees them.
- **It says the plan is read-only.** The Free plan lets connected apps read but not change things. Upgrade on the Plan &amp; billing page, or ask it only to read and summarise.
- **It says the connector is turned off.** Formidable has paused the connector for a moment. Try again later, or do it in the portal for now.
- **&quot;Too many API tokens&quot; when connecting.** In Formidable, open API tokens and revoke one you no longer use, then connect again.

---

*Technical reference: https://staging.formidable.sh/docs/mcp/ and https://staging.formidable.sh/docs/api/*
