Formio MCP Server
by formioio.form/formio-mcpv0.14.1
Create and manage Form.io forms, resources, actions, roles, and projects from your AI agent.
context tax
queued
security
queued
cold start
queued
freshness
Active4d ago
Install Formio MCP server
Install in Claude Code
claude mcp add formio -e FORMIO_API_KEY='<formio-api-key>' -- npx -y @formio/mcpInstall in Cursor
{
"mcpServers": {
"formio": {
"command": "npx",
"args": [
"-y",
"@formio/mcp"
],
"env": {
"FORMIO_API_KEY": "<formio-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"formio": {
"command": "npx",
"args": [
"-y",
"@formio/mcp"
],
"env": {
"FORMIO_API_KEY": "<formio-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"formio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@formio/mcp"
],
"env": {
"FORMIO_API_KEY": "<formio-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"formio": {
"command": "npx",
"args": [
"-y",
"@formio/mcp"
],
"env": {
"FORMIO_API_KEY": "<formio-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| 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_set can redirect a directory whose environment names a different project. Useful for a launch with nowhere to record a project, such as CI or a container (e.g. https://examples.form.io on the hosted cloud; self-hosted it is either https://your-project.your-domain.com or https://your-host/project-name, depending on how that deployment routes projects). Leave it unset and the agent asks for a project and records it per directory. |
| 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 when it cannot be derived, which is a path-less project URL on a customer domain. There is no default. Like FORMIO_PROJECT_URL it is the weakest source, behind a committed formio.json and the per-directory mapping. |
| FORMIO_API_KEY | — | yes | Form.io project API key. Optional — when omitted the server uses a browser-based portal login flow to obtain a JWT. |
| 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_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. |
| FORMIO_INSECURE_TLS | — | — | Set to 1 to skip TLS certificate verification. For local development against self-signed certificates only — never enable in production. |
Freshness
Active — last maintenance signal 4d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-05 · 4d ago · GitHub
Latest release
2026-10-05 · 4d ago · GitHub · v0.14.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 4d ago · official registry · v0.14.1
FAQ
›How do I install the Formio MCP server in Claude Code?
Run: claude mcp add formio -e FORMIO_API_KEY='<formio-api-key>' -- npx -y @formio/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Formio require an API key?
Yes. It expects FORMIO_API_KEY, of which 1 is a secret.
›Can I use Formio as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Formio in the official MCP registry?
Yes, as io.form/formio-mcp.