io.github.KamaruSama/mcp-google-forms
19 tools for Google Forms: create quizzes, add questions, set answer keys, read responses.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
mcp-google-formsclaude mcp add mcp-google-forms -e 'GOOGLE_FORMS_MCP_DIR=<GOOGLE_FORMS_MCP_DIR>' -- uvx mcp-google-forms==1.0.1{
"mcpServers": {
"mcp-google-forms": {
"command": "uvx",
"args": [
"mcp-google-forms==1.0.1"
],
"env": {
"GOOGLE_FORMS_MCP_DIR": "<GOOGLE_FORMS_MCP_DIR>"
}
}
}
}متغيرات البيئة
GOOGLE_FORMS_MCP_DIROverride the directory where OAuth credentials.json and token.json are stored (default: ~/.config/google-forms-mcp).
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
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.py3. 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).
الأسئلة الشائعة
ما هو io.github.KamaruSama/mcp-google-forms؟
19 tools for Google Forms: create quizzes, add questions, set answer keys, read responses.
كيف أثبّت io.github.KamaruSama/mcp-google-forms؟
يعمل على جهازك. في Claude Code: claude mcp add mcp-google-forms -e 'GOOGLE_FORMS_MCP_DIR=<GOOGLE_FORMS_MCP_DIR>' -- uvx mcp-google-forms==1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.KamaruSama/mcp-google-forms إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل io.github.KamaruSama/mcp-google-forms مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون io.github.KamaruSama/mcp-google-forms؟
ينشره KamaruSama. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.