# Fillout MCP by usefulapi

> Fillout MCP by usefulapi is an MCP server. Read Fillout forms and submissions, export responses, and create submissions and webhooks. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/fillout/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/fillout
- **MCP Registry name:** io.usefulapi/fillout
- **Listing updated:** 2026-11-13

## About

Read Fillout forms and submissions, export responses, and create submissions and webhooks.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http fillout https://fillout.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://fillout.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fillout": {
      "url": "https://fillout.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fillout": {
      "type": "http",
      "url": "https://fillout.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fillout": {
      "serverUrl": "https://fillout.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fillout": {
      "type": "http",
      "url": "https://fillout.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `fillout_list_forms`: List every form in the Fillout account — each form's name and formId. Start here to find the formId the other tools need. Fillout: GET /forms.
- `fillout_get_form`: Fetch one form's metadata: every question (id, name, type), calculations, URL parameters, scheduling and payment fields, and quiz settings. Use the question ids to read answers or to create submissions. Fillout: GET /forms/{formId}.
- `fillout_list_submissions`: List one page of a form's submissions (answers to every question, calculations, URL parameters, scheduling, payments, quiz score, login email), filtered by date range, status or free-text search. Offset pagination: the response carries totalResponses and pageCount. Fillout: GET /forms/{formId}/submissions.
- `fillout_get_submission`: Fetch a single submission by id, with every answer. Fillout: GET /forms/{formId}/submissions/{submissionId}.
- `fillout_count_submissions`: Count a form's submissions matching the same filters as fillout_list_submissions (date range, status, search) without pulling the answers — e.g. 'how many responses this week?' or 'how many partial submissions?'. Reads totalResponses from GET /forms/{formId}/submissions with limit=1.
- `fillout_export_submissions`: Fetch many submissions in one call by walking the offset pagination (150 per page, paced under Fillout's 5 requests/second limit), up to max_submissions. Same filters as fillout_list_submissions. Use this for analysis across a whole response set; the result says whether it was truncated. Fillout: GET /forms/{formId}/submissions (repeated).
- `fillout_create_submissions`: Create up to 10 new submissions on a form, as if respondents had filled it in — e.g. to import responses collected elsewhere. Each submission needs its question answers (question ids from fillout_get_form); URL parameters, scheduling, payments, login email and timestamps are optional. Creates real records that trigger the form's integrations. Fillout: POST /forms/{formId}/submissions.
- `fillout_create_webhook`: Subscribe a URL to a form's new submissions: Fillout will POST each submission (same shape as a fillout_list_submissions entry) to it. Returns the webhook id — keep it, it is the only handle for removing the webhook later. Fillout: POST /webhook/create.
- `fillout_remove_webhook`: Stop a webhook from receiving submissions. Recoverable: create it again with fillout_create_webhook (it gets a new id). Fillout: POST /webhook/delete.

## FAQ

### How do I add Fillout MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http fillout https://fillout.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/fillout-mcp-by-usefulapi
