What it can access
The approval page lists exactly what the assistant asked for. The connector acts as you, only on your own forms, and within your plan's limits.
- View your forms, quizzes and their questions
forms:read - Create, edit, export and publish forms and quizzes in your account
forms:write - View your document conversions and their status
jobs:read
It cannot see your password, your billing details or other people's forms, and it cannot delete your account. Access lasts until you disconnect it under Settings, API in Formswrite, which stops it at once.
Things to ask
- Find my photosynthesis quiz in Formswrite and show me its questions.
- Convert this Google Doc into a quiz: https://docs.google.com/document/d/... and tell me when it is ready.
- Create a 5-question multiple choice quiz about the water cycle for grade 6, with an answer key.
- In my "Cell biology" quiz, make question 3 required and add a fourth answer option.
- Export my "Unit 4 review" quiz to Kahoot, then publish it as a Formswrite form and give me the link.
Tools
| Tool | What it does | Changes data |
|---|---|---|
search | Find forms and quizzes in the connected account by name. | No |
fetch | Read one form in full: title, instructions, questions, options and answer key. | No |
get_account_info | Show which Formswrite account is connected and its plan. | No |
convert_document | Convert a Google Doc, a public file, a file from your computer or pasted text into a form or quiz, optionally exporting it in the same call. | Yes |
create_upload_url | Get a one-time upload URL for a file on your computer, to convert with convert_document. | Yes |
list_jobs | List the forms and conversions in the connected account, newest first. | No |
get_job | Check the status and result of one conversion. | No |
get_form_data | Read the questions and settings of a form, paginated. | No |
create_form | Create a new empty form. | Yes |
create_form_from_spec | Create a complete form in one call from a title and a list of questions with options, answer keys and points, optionally exporting or publishing it. | Yes |
modify_questions | Add, edit, delete or reorder the questions of a form. | Yes |
export_form | Export a form to Google Forms, Moodle, Canvas, Kahoot, Quizizz and 36 more formats. | Yes |
publish_form | Publish a Formswrite-hosted form and open it to responses. | Yes |
update_form_metadata | Change the title or the introduction of a form. | Yes |
Documentation server
Formswrite has a second, separate MCP server for its documentation at https://docs.formswrite.com/mcp. It searches and reads the Formswrite guides and API reference, needs no sign-in, and cannot see or change anything in your account. Add it next to the connector above when you want the assistant to answer questions about how Formswrite works.
For developers and coding agents
The public repository github.com/formswrite/formswrite-mcp holds the instructions for AI coding agents (AGENTS.md and SKILL.md) and a small bridge for MCP clients that can only run a local server. The bridge needs an API token from Settings, API in the FORMSWRITE_API_TOKEN environment variable:
npx -y github:formswrite/formswrite-mcp
Your data
The connector sends the assistant only what a tool returns: the forms you ask about, their questions, and the status of your conversions. Documents you convert are processed by Formswrite the same way as in the dashboard. See the privacy policy and the terms of service.
Troubleshooting and support
- The assistant asks you to sign in again: approve the connection once more. Nothing in your account is lost.
- A tool says it needs a permission: reconnect and approve the permission it names.
- Exporting to Google Forms fails: connect your Google account in the Formswrite dashboard first.
- Publishing is refused on the Free plan: it allows a limited number of published forms each month.
Questions or problems: [email protected] or the contact page. Developers: see the authentication guide and the server card.