Coding agent
Connect Codex to WebForms
Add https://agents.webforms.to to Codex with one command and sign in with codex mcp login. Codex can then create forms, put them into your project and check that submissions arrive, in the CLI or the IDE extension.
Needs a WebForms Pro or Agency workspace. Steps checked against OpenAI's documentation on .
MCP server URL
https://agents.webforms.to
Remote MCP over Streamable HTTP, with sign-in, so there is no API key to copy. Full details are in the MCP server docs.
Set it up
Add the server
Run
codex mcp addas below. It writes the server to~/.codex/config.toml.Start the sign-in
Run
codex mcp login webforms. On a machine without a browser, add--no-browserand paste the redirect URL back into the terminal.Sign in to WebForms
A WebForms page opens in your browser. Pick the workspace, tick what the agent may do, and click
Allow. You are sent back and the tools are ready.
codex mcp add webforms --url https://agents.webforms.to codex mcp login webforms
Or add it to the config file yourself:
[mcp_servers.webforms] url = "https://agents.webforms.to"
What Codex can and cannot do
When you sign in, WebForms asks which workspace to connect and what Codex may do. You choose:
Read forms, submissions and stats
Always included.
Create and change forms
Create forms and change their settings. It can never delete anything.
Replay failed deliveries
Send deliveries that gave up again, for example after a webhook was fixed.
It can never delete data, add destinations or send email. Access lasts 90 days and shows up under Settings, Connected AI apps, where you can disconnect it at any time. The workspace's owners and admins get an email when an AI app is connected. Connecting is available on Pro and Agency.
Things to ask Codex
- “Which of my forms gets the most spam?”
- “Show me the latest enquiries from the contact form and summarise what people want.”
- “Find every submission that mentions a refund.”
- “How much of my monthly allowance is left?”
- “Create a waitlist form with name and email, and give me the HTML to paste.”
- “Did any webhook deliveries fail this week? I fixed the endpoint, so replay them.”
- “Which visitors started the project enquiry form but never sent it?”
Tools it gets
Read
list_formsEvery form in the workspace, with its submission and spam counts.get_formOne form's settings: endpoint, thank-you page, spam settings and allowed sites.get_submissionsRecent submissions for a form, with their field data, newest first.search_submissionsSearch submission content across every form.get_statsSubmission counts over the last N days.get_usageYour plan, monthly allowance and how much of it is used.get_unfinished_submissionsForms visitors started but never sent, when the form keeps them.get_form_schemaA form's fields and the JSON Schema, TypeScript, Zod and HTML generated from them.list_deliveriesRecent delivery attempts to each destination, with status and error.
Change (only if you allow it)
create_formCreate a form. Returns its endpoint and a ready-to-paste HTML form.update_formChange a form's name, thank-you page, spam settings or allowed sites.save_form_schemaSet a form's fields and whether submissions are validated against them.replay_failed_deliveriesSend deliveries that gave up in the last 30 days again. Never re-sends email.
Using an API key instead
If you would rather not sign in, create an API key under Settings, API keys in WebForms (tick the write scopes you want it to have) and send it as a bearer token. Keep the key out of shared or committed files. Codex reads it from an environment variable, so it never sits in the config file.
[mcp_servers.webforms] url = "https://agents.webforms.to" bearer_token_env_var = "WEBFORMS_API_KEY"
Worth knowing
- In the Codex IDE extension, open the gear menu, choose MCP servers, Add server, pick Streamable HTTP, enter the URL, and restart the extension.
Codex and WebForms FAQ
Yes. Add the server from the extension's MCP settings, or share the same config.toml the CLI uses.
Access lasts 90 days. Run codex mcp login webforms again.
OpenAI documentation
Other AI agents
- ClaudeClaude on the web and the Claude desktop app, as a custom connector.
- Claude CodeAdd WebForms to Claude Code with one command.
- ChatGPTAdd WebForms to ChatGPT as a custom MCP server.
- CursorAdd WebForms to Cursor's agent with one line of config.
- GitHub Copilot in VS CodeCopilot's agent mode in VS Code.
- WindsurfAdd WebForms to Cascade in Windsurf.
- Gemini CLIAdd WebForms to Gemini CLI with one command.
Connect Codex in a minute
Add https://agents.webforms.to, sign in, and choose what it may do.