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

Links

• Product: formlova.com
• Setup guide: formlova.com/en/setup
• Public repo: github.com/formlova/formlova-mcp