Connect the Google Forms MCP server to your AI agent Open source, MIT, on npm. Setup instructions for Claude, Cursor and Codex are in the repository; adoption questions — Telegram. GitHub repository Telegram

Google Forms MCP capabilities

This catalog contains 13 public pages—one for every registered MCP tool in mcp-google-forms. Each page starts with the user's task, explains the result, and states whether the call changes real data.

Use this catalog to choose a ready-made capability. Full parameter schemas and API response details remain in the technical reference.

Items and questions

  • Add a question — Adds a question to the form (a convenience wrapper over batchUpdate createItem). Impact: changes data.
  • Delete an item — Deletes the item at the given 0-based index (question, page break, text block, ...). Impact: destructive operation.
  • Move an item — Moves the item at from_index to to_index (both 0-based, to_index is the position after removal). Impact: changes data.
  • Update an item — Updates an existing item (question or other) via batchUpdate updateItem. Impact: destructive operation.

Forms

  • Create a form — Creates a new Google Form and returns it (formId, revisionId, responderUri, publishSettings). Impact: changes data.
  • Get a form — Returns the full form: info (title, description), settings (quiz mode, email collection), items[] with their itemId/questionId and question definitions, publishSettings, responderUri and linkedSheetId. Impact: read-only.
  • Publish or unpublish a form — Publishes or unpublishes the form and opens/closes response collection. Impact: destructive operation.
  • Update form info — Changes the form's title and/or description. Impact: destructive operation.
  • Update form settings — Toggles quiz mode (grading with points) and/or the email collection mode. Impact: destructive operation.

Responses

  • Get one response — Fetches a single submission by its responseId (from list_responses): answers keyed by questionId, createTime, lastSubmittedTime, respondentEmail and totalScore when available. Impact: read-only.
  • List form responses — Lists submitted responses: responseId, createTime, lastSubmittedTime, respondentEmail (only when email collection is on), answers keyed by questionId (map questionId → question via get_form), and totalScore for graded quizzes. Impact: read-only.

Watches

Additional API methods

  • Raw Google Forms API call — Escape hatch to call any Google Forms API v1 path directly, for requests the typed tools don't cover — e.g. Impact: destructive operation.

For maintainers and publishers