Overview
What is Formswrite?
Formswrite is an MCP server that connects Claude Desktop, Cursor, Claude Code, and other MCP clients to the Formswrite API. It lets you convert Google Docs, PDFs, or pasted text into Google Forms, edit questions, list and publish forms, and run AI form assistant tools—all from your LLM.
How to use Formswrite?
Install the package @formswrite/mcp via npx, set the FORMSWRITE_API_TOKEN environment variable with an API token from your Formswrite dashboard, and add the server configuration to your MCP client (Claude Desktop, Cursor, or Claude Code). Alternatively, if your client supports Streamable HTTP natively (Cursor 0.45+, ChatGPT MCP, recent Claude Desktop), you can connect directly to https://mcp.formswrite.com/mcp with an Authorization: Bearer fw_... header.
Key features of Formswrite
- Convert documents (Google Doc, PDF, text) to forms.
- Read current form questions, options, and metadata.
- Add, edit, delete, or reorder questions.
- Update form title, description, or introduction.
- Publish draft forms to accept responses.
- Export forms to Google Forms, Moodle, Kahoot, and 25+ formats.
- Browse and inspect conversion jobs.
Use cases of Formswrite
- Quickly turn a meeting agenda or lesson plan into a Google Form.
- Modify form questions based on feedback without opening the form editor.
- Mass‑export forms to multiple quiz platforms for different classrooms.
- Automate form publishing and metadata updates as part of a workflow.
FAQ from Formswrite
What API token is required?
Sign in to your Formswrite dashboard at https://app.formswrite.com/settings/api-tokens and create an API token. Set it as the environment variable FORMSWRITE_API_TOKEN.
How do I install this server for Claude Desktop?
Edit the MCP configuration file (claude_desktop_config.json) to add the formswrite server with command: "npx", args: ["-y", "@formswrite/mcp"], and the token in the env block. Restart Claude Desktop to see the tools.
What if I get a 401 unauthorized error?
The token is invalid, expired, or for the wrong environment. Generate a new token from your Formswrite dashboard and update the FORMSWRITE_API_TOKEN value.
Can I use Formswrite without installing this npm package?
Yes, if your MCP client supports Streamable HTTP natively (e.g., Cursor 0.45+, ChatGPT MCP), you can connect directly to https://mcp.formswrite.com/mcp with the token in an Authorization: Bearer header.
Does Formswrite store or see my form data locally?
No. All tool logic runs on the Formswrite backend. This package is a lightweight bridge that forwards JSON‑RPC messages between your client and the server; it never sees your form data outside of forwarding it.
