mcp-server-google-forms
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GOOGLE_FORMS_MCP_DIR | No | Optional directory to store credentials and configuration. If set, this directory is used instead of the default locations (e.g., ~/.config/mcp-server-google-forms/). Useful for custom setups or multi-machine environments. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_formA | Cria um novo Google Form vazio e retorna o ID, o link de edição e o link de respostas. Por padrão o Google cria o formulário JÁ PUBLICADO; use unpublished=true para criá-lo como rascunho. A resposta informa o estado real de publicação. |
| set_publishA | Publica ou despublica um formulário. Formulários criados via API nascem despublicados e não aceitam respostas até serem publicados. |
| update_form_infoA | Altera o título e/ou a descrição de um formulário existente (o que aparece no topo para quem responde). O nome do arquivo no Drive (documentTitle) não pode ser alterado pela API depois da criação. |
| get_formA | Mostra a estrutura de um formulário: dados gerais e a lista de itens com as posições (use-as em add_question, delete_question e move_question). Com raw=true, inclui também o JSON completo da API. |
| add_questionA | Acrescenta uma pergunta a um formulário (no final, ou na posição indicada por 'index'). Tipos: texto curto/longo, escolha (única, múltipla, lista), escala linear, data, hora e avaliação. Para valer pontos ('points'), o formulário precisa estar em modo quiz — use set_quiz antes. |
| update_questionA | Altera uma pergunta existente na posição indicada: enunciado, obrigatoriedade, alternativas, pontos e gabarito — sem apagar e recriar, preservando o vínculo com respostas já recebidas. Confira a posição com get_form. |
| build_formA | Cria um formulário inteiro numa única operação: título, descrição, modo quiz e todas as perguntas na ordem dada. Prefira esta ferramenta a encadear create_form + várias add_question. Por padrão o Google cria o formulário JÁ PUBLICADO; use unpublished=true para criá-lo como rascunho. |
| add_sectionA | Insere uma quebra de seção (nova página) no formulário: quem responde avança de seção com o botão 'Próxima'. As posições contam todos os itens — confira com get_form. |
| add_text_itemA | Insere um bloco de texto estático (título + texto explicativo) entre as perguntas — sem campo de resposta. As posições contam todos os itens — confira com get_form. |
| set_quizA | Liga ou desliga o modo quiz (com notas) de um formulário. |
| delete_questionA | Remove a pergunta na posição indicada. As posições contam TODOS os itens (0 = primeiro) — confira antes com get_form. Recusa apagar itens que não sejam perguntas. |
| move_questionA | Move um item de uma posição para outra. As posições contam TODOS os itens (0 = primeiro) — confira antes com get_form. |
| list_responsesA | Lista as respostas de um formulário, já com o enunciado de cada pergunta no lugar do código interno. Vem em páginas (padrão: 50 por vez); se houver mais, a saída traz o pageToken da página seguinte. |
| verify_answer_keysA | Confere o gabarito de um quiz comparando com o esperado: para cada posição, verifica a(s) resposta(s) correta(s) e, se informados, os pontos. Útil para auditar um quiz recém-montado antes de divulgar. |
| auth_statusA | Verifica a configuração de acesso ao Google sem alterar nada: se o arquivo de credenciais existe, se está completo e se o Google aceita o refresh token. Use quando alguma ferramenta falhar por autenticação. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Each tool targets a distinct resource/action: questions (add/update/delete/move), form metadata (create/get/update info, build), settings (publish, quiz), responses (list), and auth (status). No two tools serve the same purpose, and descriptions clarify any minor overlaps.
Almost all tools follow a clear verb_noun pattern (e.g., create_form, list_responses, delete_question). The only exception is auth_status, which is a noun phrase, but its purpose is unambiguous and the overall convention is consistent.
15 tools is within the well-scoped range for a Google Forms server, covering the full lifecycle (create, read, update, delete questions, manage form settings, list responses). build_form is a convenience wrapper but earns its place.
The tool set covers core CRUD operations, quiz configuration, and response retrieval. Minor gaps include no direct way to delete a form or list all forms, but these are often handled outside the Forms API and are not critical for typical workflows.