MCP Server Google Forms

Cria, edita e publica Google Forms a partir do Claude: quizzes, seções e leitura de respostas.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-google-forms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-google-forms"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

mcp-server-google-forms

Servidor MCP local que permite ao Claude Code criar, editar e publicar Google Forms — apresentado aos usuários como "Forms IA (MCP)", um app verificado pelo Google. Código de exemplo do livro sobre Claude Code.

✅ Ficou fácil: você não precisa criar nada no Google Cloud nem baixar arquivos de credenciais. É instalar, entrar com a sua conta Google (tela limpa, sem avisos) e usar. Há também uma versão em página, com cards — talvez mais confortável de ler.

Índice

Início rápido
Guia completo para quem não programa
Ferramentas (15)
Solução de problemas
Usar o próprio projeto do Google Cloud (avançado)
Referência técnica
Documentação
Citação · Licença

Início rápido

Tem Node.js 18+, o Claude Code e uma conta Google? Então são dois comandos:

bash

# 1. Autorize com o Google (o navegador abre; app verificado, sem avisos)
npx -p mcp-server-google-forms mcp-server-google-forms-token

# 2. Registre no Claude Code
claude mcp add google-forms -- npx mcp-server-google-forms

Quer o passo a passo detalhado, escrito para quem não programa? Siga o guia abaixo. 👇

Guia completo para quem não programa

Pré-requisitos

Node.js 18 ou mais novo. É o programa que faz o servidor rodar; os comandos npm e npx vêm junto com ele. Para conferir, abra o terminal (veja abaixo) e digite node --version. Se aparecer v18… ou maior, está pronto. Se não, baixe a versão LTS em nodejs.org e instale (é só avançar/próximo).
O Claude Code instalado — é por ele que você conversa com o servidor (code.claude.com/docs).
Uma conta Google (a mesma em que os formulários vão aparecer).

Como abrir o terminal (é onde você cola os comandos):

Windows: menu Iniciar → digite PowerShell → abra o Windows PowerShell.
Mac: aperte Cmd + Espaço, digite Terminal e dê Enter.
Linux: procure por Terminal no menu de aplicativos (ou Ctrl + Alt + T).

💡 Neste guia, "rode o comando X" significa sempre: abra o terminal, cole o X e aperte Enter.

Passo 1 — Autorize com a sua conta Google

Rode o comando de autorização:
Terminal
```
npx -p mcp-server-google-forms mcp-server-google-forms-token
```
O navegador abre sozinho na tela de login do Google.
Entre com a sua conta e permita o acesso. A tela mostra o app Forms IA (MCP) — verificado pelo Google, sem avisos de segurança. Confira as permissões (criar/editar formulários e ler respostas) e clique em Continuar/Permitir. No terminal aparece "Pronto. refreshToken salvo…" — deu certo.

Passo 2 — Registre no Claude Code

Terminal

claude mcp add google-forms -- npx mcp-server-google-forms

Passo 3 — Peça ao Claude

Pronto! Abra o Claude Code e peça em português, por exemplo:

"Crie um quiz de 5 perguntas sobre fotossíntese, valendo 2 pontos cada, e me dê o link para compartilhar."

Fluxo típico: build_form (ou create_form → add_question) → compartilhar o link de resposta → list_responses.

Sobre publicação: verificamos na prática (10/07/2026) que a API cria formulários já publicados por padrão, ao contrário do que a documentação do Google sugeria. Por isso as ferramentas de criação aceitam unpublished=true (criar como rascunho) e informam o estado real devolvido pela API — e o set_publish cobre os dois sentidos.

Usar em outro computador

É só repetir os Passos 1 e 2 na máquina nova — sem arquivos, sem configuração. Atalho para quem não quer refazer o login: copie a pasta ~/.config/mcp-server-google-forms/ (no Windows, C:\Users\SeuNome\.config\mcp-server-google-forms\) do computador antigo para o mesmo lugar no novo — o config.json dentro dela guarda a sua autorização.

🤔 Por que essa pasta fica "oculta"?

O caminho começa com um ponto (.config) e, por isso, a pasta não aparece por padrão no Explorer (Windows) nem no Finder (Mac). Isso é intencional: programas guardam suas configurações em pastas agrupadas em ~/.config (o ~ representa a sua pasta de usuário), fora da vista, para não poluir os seus documentos. "Oculta" não significa "protegida" — a pasta é sua e pode ser aberta a qualquer momento: cole o caminho na barra de endereço do Explorer, ou use Cmd + Shift + G no Finder. É ali que o servidor guarda a sua autorização (config.json).

💻 Prefere clonar o repositório? (para quem for mexer no código)

Clone e instale:

Code

git clone https://github.com/claude-book/mcp-server-google-forms.git
cd mcp-server-google-forms
npm install

Autorize: rode npm run token e aprove no navegador.
Registre no Claude Code (rodando na raiz do projeto):
Terminal
```
claude mcp add google-forms -- node "$(pwd)/src/server.js"
```

Ferramentas (15)

Ferramenta	O que faz
`create_form`	Cria um formulário e devolve o ID e os links. Por padrão o Google o cria já publicado; use `unpublished=true` para rascunho. A resposta informa o estado real.
`build_form`	Cria o formulário inteiro numa única operação: título, descrição, modo quiz e todas as perguntas.
`set_publish`	Publica ou despublica o formulário (libera ou bloqueia respostas).
`get_form`	Mostra a lista de itens com as posições e a estrutura completa.
`add_question`	Acrescenta uma pergunta (no final ou numa posição). Nove tipos: texto curto/longo, escolha única, caixas de seleção, lista suspensa, escala linear, data, hora/duração e avaliação (estrelas, corações ou joinhas).
`update_form_info`	Altera o título e/ou a descrição de um formulário existente.
`update_question`	Edita uma pergunta existente (enunciado, obrigatoriedade, alternativas, pontos, gabarito) sem apagar e recriar — preserva o vínculo com respostas já recebidas.
`set_quiz`	Liga ou desliga o modo quiz (com notas). Obrigatório antes de usar `points`.
`add_section`	Insere uma quebra de seção (nova página) na posição indicada.
`add_text_item`	Insere um bloco de texto explicativo (sem campo de resposta) na posição indicada.
`delete_question`	Remove a pergunta na posição indicada (recusa apagar o que não for pergunta).
`move_question`	Move um item de uma posição para outra.
`list_responses`	Lista as respostas, incluindo perguntas de upload de arquivo. Em páginas (padrão 50), com `pageSize`/`pageToken`.
`verify_answer_keys`	Confere o gabarito de um quiz contra uma lista esperada (auditoria pós-criação).
`auth_status`	Diagnóstico das credenciais: arquivo presente, campos completos e teste real com o Google.

Solução de problemas

"Credenciais expiradas ou revogadas" — rode o comando de autorização de novo (Passo 1) e refaça o login; o servidor recarrega as credenciais sozinho, sem precisar reiniciar.
O navegador não abriu na autorização? — o terminal também imprime a URL; copie e cole no navegador.
Usa o seu próprio projeto do Google Cloud? Os problemas específicos desse caso estão na seção abaixo.

Para um diagnóstico rápido, peça ao Claude para rodar a ferramenta auth_status: ela testa as credenciais direto com o Google.

Usar o próprio projeto do Google Cloud (avançado)

Por padrão, a autorização usa a credencial embutida do app Forms IA (MCP), verificado pelo Google — e a sua autorização e os seus dados continuam só na sua conta e na sua máquina (detalhes em src/default-client.js). Se preferir usar um projeto seu (por exemplo, para ter as suas próprias cotas), o app respeita: um client_secret*.json na pasta de credenciais tem prioridade sobre a credencial embutida.

Passo a passo do projeto próprio

Em console.cloud.google.com: crie um projeto → ative a Google Forms API → configure a Tela de permissão OAuth (tipo Externo) → adicione-se como usuário de teste (sem isso, a autorização falha com "acesso negado") → crie a credencial (ID do cliente OAuth, tipo App para computador).
Baixe o JSON na hora da criação — o Google não permite baixá-lo depois (se perder, crie outro cliente).
Coloque o client_secret*.json em ~/.config/mcp-server-google-forms/ (Windows: C:\Users\SeuNome\.config\mcp-server-google-forms\) — ou em credentials/, na instalação por clone.
Rode o comando de autorização; o terminal confirma: "Usando o seu projeto próprio do Google Cloud".

Avisos que só aparecem no projeto próprio:

"O Google não verificou este app" — normal (o app é seu); clique em Avançado → Acessar … (não seguro).
"Acesso negado" / access_denied — você não se adicionou como usuário de teste; volte à Tela de permissão.
Expiração de 7 dias — em modo Testing, o Google expira a autorização a cada 7 dias; publique o app (Tela de permissão OAuth → Publicar app) para resolver. Para uso pessoal não é preciso passar pela verificação.

Referência técnica

Estrutura da pasta

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Server Google Forms

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "mcp-server-google-forms": { "command": "npx", "args": ["-y", "mcp-server-google-forms"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

MCP Server Google Forms AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/mcp-server-google-forms?style=directory)](https://allmcps.com/mcp/mcp-server-google-forms)

HTML Embed

<a href="https://allmcps.com/mcp/mcp-server-google-forms"><img src="https://allmcps.com/api/badge/mcp-server-google-forms?style=directory" alt="MCP Server Google Forms on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to MCP Server Google Forms →Install in Claude Desktop Install in Cursor Install in VS Code