# Connect Formidable to Claude, ChatGPT and other AI apps

Formidable works as a **connector** (an MCP server) for AI apps. Once
connected you can ask things like:

- "What came in on my Contact form this week? Anything urgent?"
- "Make a job application form with name, email, CV upload and a cover letter."
- "Mark the obvious sales pitches in my support form as spam."
- "Pause the event sign-up form, it's full."
- "Make the contact form green with rounded corners, and say 'Thanks, we'll call you back' after sending."
- "Send new job applications to my Zapier webhook."
- "Bring back the submissions I deleted yesterday."

## Adding it

The connector's address is:

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

- **Claude** (claude.ai or the desktop app): Settings → Connectors → *Add
  custom connector*, paste the address, then *Connect*.
- **ChatGPT**: Settings → Connectors → *Create* (developer mode), paste the
  address, authentication *OAuth*.
- **Claude Code**: `claude mcp add --transport http formidable https://staging-api.formidable.sh/mcp`

The app sends you to Formidable to sign in and approve. You choose **all
your forms** or **only some**. Approving creates an API token named
"*App* (connector)"; revoke it under **Account menu → API tokens** to
disconnect.

Apps that can't sign in can use an API token you make yourself, sent as
`Authorization: Bearer fm_...`.

## What it can do

| Tool | Needs | Does |
|---|---|---|
| `formidable_list_forms`, `formidable_get_form` | `forms:read` | Your forms, fields, settings and links |
| `formidable_account` | `forms:read` | You, your plan and how it's billed, limits, usage, features |
| `formidable_list_submissions`, `formidable_get_submission` | `entries:read` | Submissions (spam left out unless asked), search, date range, unread |
| `formidable_create_form`, `formidable_update_form` | `forms:write` | Make or change a form, pause or resume it |
| `formidable_delete_form` | `forms:write` | Delete a form |
| `formidable_update_submissions` | `entries:write` | Mark read / spam / not spam, delete (to the trash), remove files, restore or purge from the trash |
| `formidable_get_design`, `formidable_update_design` | `forms:read` / `forms:write` | How a form looks: design, brand colour, corners, font, title, thank-you text |
| `formidable_list_webhooks` | `forms:read` | A form's webhooks and recent deliveries |
| `formidable_add_webhook`, `formidable_update_webhook`, `formidable_test_webhook`, `formidable_delete_webhook` | `forms:write` | Send submissions to other systems (paid plans) |

Your plan decides what's allowed, the same as the [API](https://staging.formidable.sh/docs/api/):
on the Free plan the connector can read but not change anything. It never
reaches billing, account settings or other people's forms.

Submissions contain other people's personal data. The AI app sees what it
asks for, so connect only apps you trust, and only the forms they need.

---

*Machine-readable: [https://staging.formidable.sh/docs/mcp.md](https://staging.formidable.sh/docs/mcp.md)*
