Formio MCP logo

Formio MCP

Manage Form.io forms, resources, actions, roles, and projects through MCP tools for AI coding agents.

Install Formio MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp@0.14.1"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 21 tools correctly (1mo ago).

Overview

The formio-mcp MCP server connects AI coding agents to Form.io Enterprise Server for managing forms, resources, actions, roles, and projects. It exposes Form.io operations as MCP tools, including form creation and listing and project import workflows. Use it when an agent needs to build or maintain Form.io-backed applications instead of handling those platform operations manually. Project configuration is resolved per working directory, with support for committed configuration and local project records.

Use cases

  • Create Form.io forms from an agent
  • List and manage project forms
  • Configure roles and actions
  • Import Form.io projects
  • Build Form.io-backed applications

Key features

  • Form creation and listing tools
  • Resource, role, and action management
  • Project import and configuration
  • Per-directory project resolution
  • Diagnostic project operations
  • Agent skill library for Form.io workflows

Tools21

What Formio MCP lets your agent do. Expand a tool for its parameters.

Verified live~8.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

20/21 checks healthy over the last 92d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · @formio/mcp@0.14.1 (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
npm downloads2.8kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed21Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Formio MCP works

What formio-mcp MCP server does

The formio-mcp MCP server exposes Form.io Enterprise Server operations to MCP-compatible AI coding environments. Its tool groups cover forms, roles, actions, projects, and diagnostics. The repository also describes operations for Form.io resources, allowing an agent to work with the application data model alongside form definitions and related configuration.

The server is intended for projects built on Form.io. An agent can use tools such as form_create, form_list, and project_import, while the broader toolset is organized around form_*, role_*, action_*, and project_* operations. The repository presents this as a way to build complete applications with Form.io-managed data models, forms, workflows, and business logic.

How it works

The formio-mcp MCP server is installed as the @formio/mcp package and connected to an agentic coding client through MCP. The repository also provides @formio/ai, which bundles the MCP server with a skills library for coding agents. Skills can guide workflows such as form building, wizard creation, form embedding, resource planning, authentication and authorization, and use of the Form.io JavaScript SDK.

Project resolution is scoped to the working directory. The server can read a committed formio.json file containing a projectUrl, or use a per-directory record managed through the command line. The project URL identifies the Form.io project endpoint. A base URL can be derived in common deployment layouts, while some self-hosted subdomain deployments require it to be supplied explicitly.

Setup and configuration

The skills library can be installed with npx skills add formio/ai. This installs skills into .agents/skills/; the bundled setup skill can then write the MCP configuration for the selected client. The repository also documents a Claude Code plugin installation that includes both the skills and the MCP server.

For direct project setup, the package provides commands such as project get and project set. A typical setup records a project URL for the current directory. Alternatively, placing formio.json in the application directory makes the project setting shareable with the codebase; the server reads this file and does not write to it. project set --reset removes the local directory record.

Self-hosted deployments may need both a project URL and a base URL. The documented --force option is intended for a specific deployment pairing and is available to the shell command, not to the project_set MCP tool.

Tools and capabilities

  • Create and list Form.io forms.
  • Manage Form.io resources, roles, and actions.
  • Import and configure projects through project tools.
  • Inspect project resolution with diagnostic and project operations.
  • Use agent skills for form building, wizards, embedding, and related application workflows.

Limitations and notes

The README identifies the target backend as Form.io Enterprise Server; it does not describe this package as a general-purpose form service for unrelated backends. Project URL and deployment routing must resolve correctly before project-dependent operations can work. SaaS projects use https://api.form.io as the base URL, while self-hosted routing can require different configuration.

The repository lists Cursor, Codex, and Copilot plugin installation as coming soon in its agent plugin section. The MCP package itself is described as usable with MCP-aware clients, but client-specific setup details are not provided for every client.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Formio MCP

formio-mcp is an MCP server that connects AI coding agents to Form.io Enterprise Server. Its main tools manage forms, resources, roles, actions, and projects, with operations such as form creation, form listing, project import, project configuration, and diagnostics exposed through the Model Context Protocol.

Install the accompanying skills with `npx skills add formio/ai`, or use the documented Claude Code plugin installation, which includes the skills and MCP server. The setup skill can write the MCP configuration for the client. The package is published as `@formio/mcp`.

Set a project URL with the `project set` command or add a `formio.json` file containing `projectUrl` to the application directory. The server resolves configuration per working directory and may derive the base URL; some self-hosted subdomain deployments require both URLs.

The MCP package is intended for MCP-aware clients, but the repository marks Cursor plugin installation as coming soon.

Yes, role and action operations are included in the documented MCP tool groups. The README organizes them under `role_*` and `action_*` operations, alongside form and project tools.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFormio MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/formio-mcp?style=directory)](https://allmcps.com/mcp/formio-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/formio-mcp"><img src="https://allmcps.com/api/badge/formio-mcp?style=directory" alt="Formio MCP on AllMCPs" /></a>