# FormLM

Lets an AI agent create forms, scored quizzes and reports on the FormLM platform from the terminal, with no web UI involved.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: formlm
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/formlm/cli
- Updated: 2026-10-10
- HTML: https://affpapa.org/en/nevibecode/mcp/formlm

## What it does

FormLM is a form and assessment platform. The `@formlm/cli` package reaches it in two ways: as a standalone CLI and as an MCP server you attach to Claude, Codex, Cursor, Copilot, Gemini CLI or another client. The agent gets 10 tools and turns a text description into a working app.

Generation runs in stages. `smart plan` locks the structure, `smart execute` builds the app, then you publish and audit. Dimension names stay put if you pass `--dimensions "A|B|C"`; `--app-name` pins the display name; `--dry-run` checks a prompt without leaving a leftover app behind. A plan can be written to a file with `--save-plan` and resumed later, after the server-side cache has expired.

You need a `FORMLM_TOKEN`, and some commands also want `FORMLM_BASE_URL`. Without the token the auth tools cannot sign in, so set it up in FormLM first. Read-only calls retry on 408, 429 and 5xx; writes are never retried automatically, which matters when you run batches.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FORMLM_TOKEN`, `FORMLM_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env FORMLM_TOKEN=<FORMLM_TOKEN> --env FORMLM_BASE_URL=<FORMLM_BASE_URL> --transport stdio formlm -- npx -y @formlm/cli
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add formlm --env FORMLM_TOKEN=<FORMLM_TOKEN> --env FORMLM_BASE_URL=<FORMLM_BASE_URL> -- npx -y @formlm/cli
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "formlm": {
            "command": "npx",
            "args": [
                "-y",
                "@formlm/cli"
            ],
            "env": {
                "FORMLM_TOKEN": "<FORMLM_TOKEN>",
                "FORMLM_BASE_URL": "<FORMLM_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "formlm": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@formlm/cli"
            ],
            "env": {
                "FORMLM_TOKEN": "<FORMLM_TOKEN>",
                "FORMLM_BASE_URL": "<FORMLM_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FORMLM_TOKEN=<FORMLM_TOKEN> -e FORMLM_BASE_URL=<FORMLM_BASE_URL> formlm npx -y @formlm/cli
```
Replace <…> with your own values

## When to use it
- turn a written description into a working form
- pin scoring dimension names and count in a quiz
- audit an app for scoring gaps and empty expert blocks
- publish a form with anonymous access and get its link
- save a plan and resume the build after the cache expires

## Example prompts
- Generate a feedback form with formlm_generate
- Run doctor on this app and list the findings
- Publish the form for anyone and give me the link

## Similar
- [google-forms](https://affpapa.org/en/nevibecode/skills/google-forms.md) — skill · 335 installs
- [recipe-collect-form-responses](https://affpapa.org/en/nevibecode/skills/recipe-collect-form-responses.md) — skill · 30100 installs
- [PDF Form Filler](https://affpapa.org/en/nevibecode/skills/pdf-form-filler.md) — skill · 4700 installs
- [form-builder](https://affpapa.org/en/nevibecode/skills/form-builder.md) — skill · 4600 installs
- [angular-developer](https://affpapa.org/en/nevibecode/skills/angular-developer.md) — skill · 46200 installs
- [angular-forms](https://affpapa.org/en/nevibecode/skills/angular-forms.md) — skill · 7100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md