formlova-mcp

Connect FORMLOVA to MCP-compatible AI clients without hand-writing common setup files.

FORMLOVA is an MCP-native form operations service. It lets you create forms, manage responses, run email workflows, and review analytics from the AI client you already use.

formlova-mcp is not the FORMLOVA server. It is a small helper for developers and teams who want setup snippets, project-level config files, and a quick connectivity check.

The fastest path

Most users do not need this package.

If your AI client already has an MCP add screen, use this URL directly:

https://formlova.com/api/mcp

Reviewing setup instructions and registering the URL does not require a FORMLOVA account. On first real use, you can log in or sign up during authentication.

If you want a CLI helper instead, start here:

npx -y formlova-mcp print --client all

If you want project-level config files written for supported developer tools:

npx -y formlova-mcp install --client all --scope project --yes

This writes config files only. Authentication still begins inside the client on first use, and some clients require a restart or reconnect before the tools appear.

What this package is for

Print copy-paste setup snippets for supported clients
Generate project-level config files for common developer tools
Check whether the FORMLOVA MCP URL is reachable from your machine
Standardize local MCP setup across a team or repo

Supported clients

ChatGPT
Claude
Codex
Claude Code
Cursor
Gemini CLI

Any MCP-compatible client can still connect with the same URL:

https://formlova.com/api/mcp

Command overview

| Command | Purpose | Writes files | | --- | --- | --- | | print | Show setup snippets for one or more clients | No | | install | Write supported project-level config files | Yes | | doctor | Check MCP URL reachability and local config presence | No |

`print`

Print setup snippets only. No files are written.

npx -y formlova-mcp print --client codex
npx -y formlova-mcp print --client claude-code
npx -y formlova-mcp print --client cursor
npx -y formlova-mcp print --client chatgpt
npx -y formlova-mcp print --client gemini-cli

`install`

Write project-level setup files for supported developer tools.

npx -y formlova-mcp install --client all --scope project --yes

install does not complete OAuth or client-side authentication for you.

Current write targets:

| Client | Path written by install | | --- | --- | | Codex | .codex/config.toml | | Claude Code | .mcp.json | | Cursor | .cursor/mcp.json |

For ChatGPT and Gemini CLI, install prints setup guidance because there is no stable local config file target in this package.

`doctor`

Check MCP URL reachability and common local config files.

npx -y formlova-mcp doctor

Client setup references

ChatGPT

Enable developer mode first
Then open Settings > Apps > Advanced settings (Create app) and add the MCP server URL
Docs: OpenAI remote MCP guide

Claude

Open Settings > Connectors
Add the remote MCP server URL
Docs: Claude remote MCP guide

Codex

codex mcp add formlova --url https://formlova.com/api/mcp

Claude Code

claude mcp add --transport http formlova https://formlova.com/api/mcp

Cursor

You can use the normal MCP UI, or a config file such as:

{
  "mcpServers": {
    "formlova": {
      "url": "https://formlova.com/api/mcp"
    }
  }
}

Gemini CLI

gemini mcp add --transport http formlova https://formlova.com/api/mcp

What it does not do

It does not run a local FORMLOVA MCP server
It does not replace the normal web-based setup flow for ChatGPT or Claude
It does not complete client-side authentication or OAuth on your behalf
It does not auto-write user-level config yet

Requirements

Node.js 18.17+

Notes

Client-side setup menus and steps may change without notice. When in doubt, ask your AI client how to add an MCP server, then use:

https://formlova.com/api/mcp

MCP Servers