FormDoc plugin for Claude Code
The FormDoc plugin teaches Claude Code to add website forms that really send. One install gives Claude three things: a skill with FormDoc’s form rules, FormDoc’s MCP server so it can create and test forms, and a hook that checks every form Claude writes and has it fix any problems.
Install
In Claude Code, run:
/plugin marketplace add https://www.formdoc.dev/claude/marketplace.json
/plugin install formdoc@formdoc
Then restart Claude Code or run /reload-plugins, and ask: “Add a contact form to this site with FormDoc.”
You need Claude Code 2.1.224 or newer and Node.js 18 or newer. To remove the plugin later, run claude plugin uninstall formdoc@formdoc in your terminal, or open /plugin and remove it there.
What’s inside
| Part | What it does |
|---|---|
formdoc-forms skill |
FormDoc’s rules for forms: the endpoint, the hidden access key, named and labelled fields, the spam trap, real success messages, and fetch code for React, Vue and Svelte. Claude uses it whenever you ask for a form, or run /formdoc:formdoc-forms |
formdoc MCP server |
Runs npx -y @formdocdev/cli mcp, so Claude can create a form for your email address, get its code, send a test and check your project. See AI assistants |
| Form check hook | After Claude edits or writes a file containing a FormDoc form, runs npx -y @formdocdev/cli check on that file. Problems are shown to Claude, which fixes them straight away |
The hook does nothing for files without a FormDoc form, and the check runs on your computer. Nothing in the plugin can read your submissions: they stay in your inbox and your FormDoc dashboard.
Prefer to set it up by hand?
Each part also works on its own:
- Skill or rules only: the Claude Code skill generator writes the skill, or the same rules for CLAUDE.md, AGENTS.md, Cursor or Copilot.
- Hook only: the Claude Code hook generator gives you the script and the settings.
- MCP server only:
claude mcp add formdoc -- npx -y @formdocdev/cli mcp, or use the MCP setup generator for other assistants.
Updates
The plugin’s version changes whenever we update it. Claude Code doesn’t auto-update plugins from other marketplaces unless you turn it on: open /plugin, go to Marketplaces, and choose Enable auto-update for formdoc. Or run /plugin marketplace update formdoc now and then.
Common questions
Is the plugin free?
Yes. The plugin is free, and forms on FormDoc’s Free plan receive 250 submissions a month with spam protection and email notifications.
Does it work on Windows?
The skill and the hook do. Some Windows setups can’t start npx directly for MCP servers; if FormDoc’s tools don’t appear in /mcp, add the server yourself with the Windows setup from the MCP setup generator.
Will the hook slow Claude down?
For files without a FormDoc form it finishes in milliseconds. For form files, the first check downloads FormDoc’s command-line tool with npx; later checks reuse it.
Does Claude need my FormDoc password or an API key?
No. Creating a form only needs your email address, and you confirm it yourself by clicking the link FormDoc sends. The access key Claude puts in your HTML is public by design.