← Back to directory
F

Form.io Agentic Coding Toolset

Official
MCP server, Claude Code plugin, and AI skills library for building Form.io applications.
GitHub source repository ↗
★ 7 Stars Category · Dev Tools Popular Source revision 0285a1c64f8a
62FMRS · C

The Form.io Agentic Coding Toolset is an official project providing a mature MCP integration for the Form.io platform. It includes a rich set of tools and skills supporting both application and form development, and offers an easy install via Claude Code plugin. The tools are stable and well-documented, but require Form.io project permissions.

Reliability
10/20
Security and permissions
13/20
Maintenance
11/20
Documentation
15/20
Setup experience
13/20
Read the FMRS scoring method →

The Form.io Agentic Coding Toolset is a comprehensive package including an MCP server (@formio/mcp), a Claude Code plugin (@formio/ai), and an AI skills library, designed to let developers perform complex actions against the Form.io Enterprise Server using their favorite agentic coding tools (starting with Claude Code). It enables creating and managing forms, resources, actions, roles, and projects, and provides a rich skill library (app orchestration, form building, resource planning, schema authoring, etc.) to accelerate development. The toolset turns Form.io into a composable backend for agentically coded applications, leveraging production-grade data, RBAC, and audit infrastructure.

Tools

form_create
Create a new form.
form_get
Fetch a single form definition by ID or path.
form_list
List forms with optional filtering and pagination.
form_update
Update an existing form.
form_revisions_list
List immutable published revision summaries for a form.
form_revision_get
Fetch a single immutable form revision.
role_create
Create a new project role.
role_list
List all project roles.
role_update
Full-replacement update of a role.
action_types_list
List all action types available on the server.
action_type_get
Get an action type's settings schema.
action_create
Attach a new action to a form.
action_list
List actions on a form.
action_get
Get a single action by ID.
action_update
Update an action.
action_delete
Detach an action from a form.
project_export
Export the project's complete template as a portable JSON document.
project_import
Import a template JSON, additively merging roles, resources, forms, and actions.
project_set
Plugin-mode only: persist a per-directory project URL mapping.
hello
Smoke-test tool returning a static greeting.

Setup

  1. Install Claude Code.\n2. Run within Claude Code: /plugin marketplace add https://github.com/formio/ai.git\n3. Run: /plugin install formio-ai@formio\nAlternatively, use the MCP server standalone by creating a .mcp.json in your project root with the configuration shown.
claude_desktop_config.json
{
  "mcpServers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ],
      "env": {
        "FORMIO_BASE_URL": "https://api.form.io",
        "FORMIO_PROJECT_URL": "https://your-project.form.io"
      }
    }
  }
}

Fit and risk

Best for

  • Developers using Form.io to build form applications within AI coding environments
  • Enterprises needing standardized data, RBAC, and audit capabilities
  • Teams using Claude Code or other MCP-aware clients

Not for

  • Developers not using the Form.io platform
  • Users seeking no-code development without AI coding tools
  • Scenarios requiring direct REST API access without MCP tool abstraction

Required permissions

  • Requires Form.io project API key or browser login authentication
  • Access to Form.io project URL and base URL
  • Ability to create, update, delete forms, roles, actions, and project resources

Risks and side effects

  • API key leakage could lead to unauthorized access
  • Importing project templates may overwrite existing items with the same machine name
  • Browser login flow may fail in CI or environments without a display
  • Using insecure TLS settings (FORMIO_INSECURE_TLS) may pose a security risk

Troubleshooting

  1. Ensure correct FORMIO_BASE_URL and FORMIO_PROJECT_URL are set
  2. Verify FORMIO_API_KEY is valid if using API key mode
  3. In CI, set FORMIO_FORCE_BROWSER=1 if unable to perform browser login
  4. Check network connectivity to the Form.io deployment
  5. Inspect server logs for error messages

Use cases

Build complete form-based applications such as CRM, help desk, and storyboard.
Create complex forms and multi-page conditional wizards, like college application or FHIR-compliant patient forms.
Embed and render Form.io forms in existing applications.
Work the REST API via natural language prompts to create resources, forms, or submissions.

Supported clients

Claude CodeFull support
Claude DesktopFull support
CursorFull support
VS Code CopilotFull support
WindsurfFull support
ClineFull support