formly-mcp

The official MCP server for Formly — create, edit, publish, and read forms from any AI agent (Claude, Cursor, Codex, ChatGPT, OpenClaw) in plain language.

Formly is an AI-powered, agentic form builder. With this Model Context Protocol (MCP) server, any MCP-compatible agent can build and manage your Formly forms just by chatting — Formly's own AI designs the structure (pages, questions, field types), so you never have to open the dashboard.

Say: "Create a customer feedback survey and publish it" → your agent builds it and hands back a live link.

Quickstart

1. Get an API key. In Formly, go to Settings → Developer and create a key (requires a Pro plan). Copy the formly_sk_… value.
2. Add Formly to your agent (pick your client below).
3. Ask your agent to build or edit a form.

Claude Desktop / Cursor

Add to your MCP config (claude_desktop_config.json or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "formly": {
      "command": "npx",
      "args": ["-y", "formly-mcp"],
      "env": {
        "FORMLY_API_KEY": "formly_sk_your_key_here"
      }
    }
  }
}

Codex CLI

codex mcp add formly --env FORMLY_API_KEY=formly_sk_your_key_here -- npx -y formly-mcp

Claude Code

claude mcp add formly --env FORMLY_API_KEY=formly_sk_your_key_here -- npx -y formly-mcp

Tools

| Tool | What it does | | --- | --- | | create_space | Create a new workspace. | | create_form | Build a brand‑new form from a natural‑language description. | | edit_form | Change an existing form's content by instruction. | | update_form_settings | Branding, redirects, email notifications, SEO, password protection, and more. | | publish_form / unpublish_form | Take a form live or offline. | | list_forms | List your forms. | | get_form | Get a form's full structure and settings. | | get_submissions | Read recent responses to a form. | | list_spaces | List your workspaces. |

Example prompts

• "Create a workspace called Recruiting and put a job application form inside it."
• "Build a job application form with name, email, and a resume upload, then publish it."
• "Add a 1–5 rating question to my customer feedback form."
• "Make the email field on my contact form required."
• "Show me the 10 most recent responses to my signup form."

Environment variables

| Variable | Required | Default | Description | | --- | --- | --- | --- | | FORMLY_API_KEY | Yes | — | Your Formly API key (formly_sk_…). | | FORMLY_API_URL | No | https://api.formly.so | Override the API base URL (e.g. for self‑hosting). |

Remote MCP (no install)

Prefer a hosted endpoint? Connect your agent to https://api.formly.so/mcp and send your API key as a bearer token — no npx required.

Requirements

• Node.js 18+
• A Formly Pro account (pricing)

Links

• Website: https://formly.so
• Developer docs: https://formly.so/developers
• npm: https://www.npmjs.com/package/formly-mcp

License

MIT