Formio MCP
Create and manage Form.io forms, resources, actions, roles, and projects from your AI agent.
Connector by form.ioOfficial · Domain verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/form-io-formio-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: frontend-development
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 9 read · 13 write · 2 delete · 1 not yet classified
- Secrets
- 2 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 25
Read from the source code; the running server may list different tools.
Read 9 · Look things up without changing anything.
action_getaction_listform_getform_listform_revision_getform_revision_listproject_getrole_listserver_status
Write 13 · Create, change, send or run things.
action_createaction_type_getaction_type_listaction_updateform_createform_publishform_updateproject_importproject_setproject_tag_createproject_tag_listrole_create
Show 1 more tools
role_update
Delete 2 · Delete, drop, revoke or wipe things.
action_deleteform_revert
Not yet classified 1 · We could not tell from the name and description.
project_export
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
FORMIO_API_KEYFORMIO_AUTH_TIMEOUT
Other settings (environment variables or headers).
FORMIO_AUTH_HOSTFORMIO_AUTH_PORTFORMIO_BASE_URLFORMIO_FORCE_BROWSERFORMIO_INSECURE_TLSFORMIO_LOGIN_FORMFORMIO_PROJECT_URLFORMIO_REQUEST_TIMEOUT
Tools (25)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
action_createCreate a new action on a form. Call action_type_get first to discover the required settings schema for the action type.
action_deleteDelete an action from a form. The action stops running on submissions immediately and is not recoverable — call action_get first if the settings may be needed again.
action_getGet a single action by ID from a form, including its handler, method, condition, and type-specific settings. Call action_list first to find the action ID.
action_listList the actions configured on a form, one page at a time — the server-side handlers that run when a submission is saved, such as save-to-resource, email, login, and role assignment.
action_type_getGet action type info and settings form schema. Call this before action_create to discover the required settings for the action type.
action_type_listList the action types available for a form. Returns the whole catalog the server supports in one result.
action_updateUpdate an existing action on a form; call action_get first if you do not already have it. Sent fields overwrite, arrays and objects whole; top-level fields left out keep their value.
form_createCreate a form in the project `cwd` resolves to. Build the form JSON with the formio-schema skill first. On a deployment licensed for revisions, `revisions` defaults to "original". Not for a draft of an existing form ("save a draft", "draft <change>"): use form_update with `draft: true`.
form_getFetch a form definition, by _id or path, from the project `cwd` resolves to. `draft: true` fetches its in-flight draft instead of the published form.
form_listList forms from the project `cwd` resolves to, one page at a time, optionally filtered by type and tags.
form_publishPublish a form's draft as its live version in the project `cwd` resolves to. Save the draft first with form_update and `draft: true`; a form with no draft fails with NO_DRAFT. Needs the revisions licence (Security Module).
form_revertRevert a form in the project `cwd` resolves to back to a prior revision: its components, tags, properties and display replace the live form's. Find it with form_revision_list. Needs the revisions licence (Security Module).
form_revision_getFetch one immutable form revision from the project `cwd` resolves to. Restore it with form_revert, passing its `_vid`.
form_revision_listList a form's published revision summaries in the project `cwd` resolves to, newest first, one page at a time. Read one with form_revision_get, or restore one with form_revert, passing its `_vid`.
form_updateUpdate a form in the project `cwd` resolves to: read it with form_get, apply the change using the formio-schema skill, and send the form. Sent fields overwrite, arrays and objects whole; top-level fields left out keep their value. Pass `draft: true` to save a draft instead of the live form; publish it with form_publish, and restore a prior revision with form_revert.
Show 10 more tools
project_exportExport the project `cwd` resolves to as a template (roles, resources, forms, actions). With `tag`, export the template that version tag stored instead — how a workspace's template.json is refreshed; Form.io does not store project-level access with a tag, so that comes from the project's current access.
project_getReport which Form.io project the working directory resolves to, which deployment hosts it, and which layer supplied each — the preflight before the first call that reads from or writes to a deployment. It uses the resolver every tool uses, so no shell command is needed. Branch on `status`: "ok" — proceed. "not-configured" — relay the message, ask the user for the one value it names, record it with project_set, and call this again. "base-url-unresolved" — the project IS recorded: ask for the Base URL alone, never the Project URL again. Reads only; project_set records a choice.
project_importImport a template's roles, resources, forms and actions into the project `cwd` resolves to, for a first build: build it with the formio-resource-planner skill. Each form it names is replaced, its actions deleted and recreated, and its `access` replaces the project's; change an existing project with the form, role and action tools instead.
project_setSet the active Form.io project for a directory: records its Project URL in ~/.formio/projects.json, keyed by the directory `cwd` resolves to. Call it whenever the user asks to set, change, or switch the project; acknowledging in text persists nothing. No restart is needed. Resolution precedence: a committed formio.json, then this mapping, then FORMIO_PROJECT_URL in the environment, the weakest — so a mapping written here DOES override the environment. `ok` and `projectUrl` on the result report the pair that resolves. Pass projectUrl alone: the Base URL is derived — https://api.form.io for a fo…
project_tag_createVersion the project `cwd` resolves to: Form.io snapshots its current state under a semver `tag` with a `description`, and the project is then at that version. Ask the user before calling. Export the version with project_export `tag`.
project_tag_listReport the version the project `cwd` resolves to is at (`current`) and its version tags, newest first. With `compare: true`, also report the roles, resources, forms and actions changed since `current` — changes made outside the agent.
role_createCreate a new role in the project `cwd` resolves to.
role_listList the roles defined in the project `cwd` resolves to, one page at a time.
role_updateUpdate an existing role in the project `cwd` resolves to. Sent fields overwrite, arrays and objects whole; top-level fields left out keep their value.
server_statusReport this server's name and version and how `cwd` resolves to a project, as project_get does. It makes no Form.io request and needs no credentials: call it first when other tools fail.
Signals
- Stars
- 8
- Forks
- 4
- Open issues
- 0
- Weekly downloads
- 304
- Last commit (this folder)
- Oct 14, 2026 (15 days ago)
- Last release
- Oct 14, 2026 (15 days ago)
- Last package publish
- Oct 14, 2026 (15 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.form/formio-mcp- Version
- 1.0.1
- Auth
- API key
- Packages
- npm @formio/mcp
- License
- MIT
- Repository
- github.com/formio/ai
- Website
- form.io
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from form.io
Cite this page
Formio MCP. Agent Mart. https://agentmart.dev/connectors/form-io-formio-mcp (last updated 2026-10-24)