# formhaus MCP server

> Allows AI agents to write, validate, and repair JSON form definitions for React, Vue, Swift, and Kotlin applications.

- Repository: https://github.com/formhaus-dev/formhaus
- Page: https://hostedmcp.org/servers/formhaus-dev/formhaus
- Transport: stdio
- Stars: 8
- License: MIT

## Install

### Claude Code

```sh
claude mcp add formhaus -- npx -y @formhaus/mcp
```

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

```json
{
  "mcpServers": {
    "formhaus": {
      "command": "npx",
      "args": [
        "-y",
        "@formhaus/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "formhaus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@formhaus/mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"formhaus","type":"stdio","command":"npx","args":["-y","@formhaus/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "formhaus": {
      "command": "npx",
      "args": [
        "-y",
        "@formhaus/mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add formhaus -- npx -y @formhaus/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.formhaus]
command = "npx"
args = ["-y", "@formhaus/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user formhaus npx -- -y @formhaus/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "formhaus": {
      "command": "npx",
      "args": [
        "-y",
        "@formhaus/mcp"
      ]
    }
  }
}
```

## FAQ

### What can the Formhaus MCP server do?

The MCP server enables AI agents to write, check, and repair form definitions locally without requiring an account.

### Can I use Formhaus with my own UI components?

Yes, both the React and Vue adapters allow you to swap native HTML inputs for your own custom components via a components prop.

### Does Formhaus support multi-step forms?

Yes, the JSON definition supports multi-step forms including fields, validation, conditional fields, steps, and branching routes.