Formswrite

Convert documents to Google Forms, edit questions, list and publish forms, and run AI form assistant tools — all from your LLM.

Once installed, your LLM gains access to the Formswrite toolset:

- create_form— create a Formswrite job from a Google Doc, PDF, or pasted text
- get_form_data— read the current questions, options, and metadata of a form
- modify_questions— add, edit, delete, or reorder questions
- update_form_metadata— update title, description, or introduction
- publish_form— publish a draft form so it can accept responses
- export_form— export a form to Google Forms, Moodle, Kahoot, Quizizz, Canvas, and 25+ other formats
- list_jobs/get_job— browse and inspect your conversion jobs

Edit~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%\Claude\claude_desktop_config.json(Windows):

{ "mcpServers": { "formswrite": { "command": "npx", "args": ["-y", "@formswrite/mcp"], "env": { "FORMSWRITE_API_TOKEN": "fw_..." } } } }

Restart Claude Desktop. The Formswrite tools will appear in the tools list.

{ "formswrite": { "command": "npx", "args": ["-y", "@formswrite/mcp"], "env": { "FORMSWRITE_API_TOKEN": "fw_..." } } }

claude mcp add formswrite -- npx -y @formswrite/mcp

Then set the token in~/.claude/settings.json:

{ "env": { "FORMSWRITE_API_TOKEN": "fw_..." } }

If your client supports theStreamable HTTPtransport natively (Cursor 0.45+, ChatGPT MCP, recent Claude Desktop), you can skip this package and connect directly:

URL: https://mcp.formswrite.com/mcp Header: Authorization: Bearer fw_...

This package is a small stdio ↔ Streamable HTTP bridge. It runs locally on your machine, opens a connection tohttps://mcp.formswrite.com/mcpusing your API token, and forwards JSON-RPC messages between your MCP client (stdio) and the Formswrite server (HTTP).

All tool logic lives on the Formswrite backend — this package contains no business logic and never sees your form data outside of forwarding it.

Diagnostic output is written tostderr(stdout is the JSON-RPC channel). To see logs:

- Claude Desktop: open the MCP logs panel (Settings → Developer)
- CLI: runFORMSWRITE_API_TOKEN=... npx @formswrite/mcp 2>&1 >/dev/null

- Missing token—FORMSWRITE_API_TOKENis not set in your client's MCPenvblock
- 401 unauthorized— token is invalid, expired, or for the wrong environment. Generate a new one at the dashboard URL above
- 429 rate_limited— you're past the 60 req/min limit; slow down

- Formswrite:https://formswrite.com
- Dashboard:https://app.formswrite.com
- Issues:https://github.com/formswrite/formswrite-mcp/issues
- MCP spec:https://modelcontextprotocol.io

Connect AI agents with the Feishu/Lark platform for automation, including document processing, conversation management, and calendar scheduling.