MCP server for managing Google Forms — quizzes, grading, images, responses. Part of likezara™ MCP suite.
Project description
mcp-google-forms
MCP server for managing Google Forms — quizzes, grading, images, responses.
Exposes 19 tools for creating, editing, inspecting, and managing Google Forms through the Model Context Protocol. Built for use with Claude Code, Claude Desktop, or any MCP-compatible client.
Tools at a glance
| Section | Tool | Purpose |
|---|---|---|
| Auth | auth_status |
Check OAuth credential state |
| Create / metadata | create_quiz_form |
New form in quiz mode |
rename_form |
Change title/description | |
set_quiz_mode |
Toggle quiz on/off | |
| Read | get_form |
Full form JSON |
list_questions |
Concise item list | |
verify_answer_keys |
Diff current vs expected answer keys | |
| Add | add_true_false_question |
Single T/F question |
batch_add_true_false |
Bulk T/F | |
add_multiple_choice_question |
Radio / checkbox / dropdown | |
add_text_question |
Short or paragraph text | |
add_section_header |
Page break / section | |
| Edit | update_question_title |
Rename question |
update_true_false_answer |
Re-key a T/F answer | |
delete_question |
Remove item | |
move_question |
Reorder | |
| Responses | list_responses |
All submitted responses |
get_response |
One response by ID | |
| Escape hatch | raw_batch_update |
Raw Forms API calls |
Install
1. Enable API + get credentials
- Go to https://console.cloud.google.com → create/select a project
- APIs & Services → Library → enable Google Forms API
- OAuth consent screen → External → add yourself as test user
- Credentials → Create Credentials → OAuth client ID → Desktop app
- Download JSON → save as:
~/.config/google-forms-mcp/credentials.json
2. Register with Claude Code
claude mcp add google-forms -s user -- \
uv run --directory /path/to/mcp-google-forms python server.py
3. First use
On the first tool call, the server opens a browser for OAuth consent. Token is cached at ~/.config/google-forms-mcp/token.json.
Scopes
forms.body— create/edit form structureforms.responses.readonly— read responsesdrive.file— attach images via Drive
Support the project ❤
If this tool helps your workflow, consider supporting development:
- Ko-fi: https://ko-fi.com/kamaru
Contact
- Portfolio / general: k.kamarux@gmail.com
- Commercial / licensing: contact@likezara.com
Copyright © 2026 likezara™. All rights reserved. Developed by Kamaru (pen name).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_google_forms-1.0.1.tar.gz.
File metadata
- Download URL: mcp_google_forms-1.0.1.tar.gz
- Upload date:
- Size: 7.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
94d92fc3a3882e6bb5def443e12a7c6680ac407cbae4a9a852470b63dc2a6d8b
|
|
| MD5 |
edd827098fa97017f5983b1e75b66d6c
|
|
| BLAKE2b-256 |
47b08e8063a6b24766418d8d776eb6c090162aa2faf67a06eb5cc79765f7b97c
|
File details
Details for the file mcp_google_forms-1.0.1-py3-none-any.whl.
File metadata
- Download URL: mcp_google_forms-1.0.1-py3-none-any.whl
- Upload date:
- Size: 8.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
254b7b7752183f6cc8836e85a69c11c517ef3028d24c87e3a2a8efbb1f5c64e5
|
|
| MD5 |
e36b82f6fb43d5e53b4c9bfb307af084
|
|
| BLAKE2b-256 |
b04e0278347fc0547672e39328f73015e942502ebcaf44b357b2abda10b1e893
|