Formio Mcp

Install

Pin version registry version 1.0.1

npm
npx -y @formio/mcp

npm
npx -y @formio/mcp@1.0.1

Setup by client

Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.

{
  "mcpServers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ],
      "env": {
        "FORMIO_API_KEY": "<YOUR_FORMIO_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp@1.0.1"
      ],
      "env": {
        "FORMIO_API_KEY": "<YOUR_FORMIO_API_KEY>"
      }
    }
  }
}

claude mcp add --env FORMIO_API_KEY=<YOUR_FORMIO_API_KEY> formio-mcp -- npx -y @formio/mcp

claude mcp add --env FORMIO_API_KEY=<YOUR_FORMIO_API_KEY> formio-mcp -- npx -y @formio/mcp@1.0.1

{
  "mcpServers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ],
      "env": {
        "FORMIO_API_KEY": "<YOUR_FORMIO_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp@1.0.1"
      ],
      "env": {
        "FORMIO_API_KEY": "<YOUR_FORMIO_API_KEY>"
      }
    }
  }
}

{
  "servers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ],
      "env": {
        "FORMIO_API_KEY": "<YOUR_FORMIO_API_KEY>"
      }
    }
  }
}

{
  "servers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp@1.0.1"
      ],
      "env": {
        "FORMIO_API_KEY": "<YOUR_FORMIO_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ],
      "env": {
        "FORMIO_API_KEY": "<YOUR_FORMIO_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp@1.0.1"
      ],
      "env": {
        "FORMIO_API_KEY": "<YOUR_FORMIO_API_KEY>"
      }
    }
  }
}

Environment variables

Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.

• FORMIO_PROJECT_URL — Optional, and the WEAKEST of the three project sources: a committed formio.json found by walking up from the working directory wins, then the per-directory mapping project_set writes, then this. It pins nothing — project
• FORMIO_BASE_URL — Optional, and usually unnecessary: the base URL is DERIVED from the project URL — https://api.form.io for a project on a form.io host, the parent path for a project addressed as a sub-directory — and is asked for only wh
• FORMIO_API_KEY secret — Form.io project API key. Optional — applied only to the project FORMIO_PROJECT_URL names, so set FORMIO_PROJECT_URL beside it; any other project, and every project when it is omitted, uses the browser-based portal login
• FORMIO_LOGIN_FORM — URL of a custom login form used by the browser-based portal login flow. Defaults to the deployment's portal login form.
• FORMIO_AUTH_HOST — Address the browser-login page binds to. Optional; defaults to 127.0.0.1. Set it to 0.0.0.0, together with FORMIO_AUTH_PORT, when the server runs in a container or on a remote machine and the login page must be reachable
• FORMIO_AUTH_PORT — Fixed port for the browser-login page, so a container can publish it (e.g. 43117). Optional; a positive integer, and by default the page takes an ephemeral port.
• FORMIO_AUTH_TIMEOUT — Seconds to wait for a browser login before the call fails with an error naming the remedies. Optional; a positive integer no larger than 2147483, and any other value is ignored. Defaults to 900.
• FORMIO_FORCE_BROWSER — Set to 1 to attempt the browser login even where the server detects it cannot present one (CI, a container, a remote shell with no display). Use it when the login page is reachable from a browser elsewhere.

GitHub

About this server