Overview
What is Google Forms MCP Server?
This MCP server uses the Google Forms API to provide functions such as creating, editing, and retrieving responses for forms. It is intended for use with AI assistants like Claude to programmatically manage Google Forms.
How to use Google Forms MCP Server?
Clone the repository, run npm run build to build the server, and npm run build:token to build the refresh token script. Set environment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and run node build/get-refresh-token.js to obtain a refresh token. Configure the server in Claude desktop app’s claude_desktop_config.json with the command node /path/to/build/index.js and the required environment variables. Restart the app to use the tools.
Key features of Google Forms MCP Server
- Create a new Google Form
- Add text questions to a form
- Add multiple choice questions to a form
- Retrieve form details
- Retrieve form responses
Use cases of Google Forms MCP Server
- Automatically create a form and add questions via Claude
- Collect and access form responses programmatically
- Integrate form creation into AI-powered workflows
FAQ from Google Forms MCP Server
How do I obtain OAuth 2.0 credentials?
Create a project in Google Cloud Console, enable the Google Forms API, and create an OAuth 2.0 Client ID with application type “Desktop app”. Then set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET as environment variables.
How do I get a refresh token?
After setting the environment variables, run node build/get-refresh-token.js (after building the token script with npm run build:token). The script will display a refresh token to copy.
How do I configure the Claude desktop app?
Open ~/Library/Application Support/Claude/claude_desktop_config.json and add an entry under mcpServers with the command node, args pointing to the built index.js, and the env object containing GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN.
What tools are available in this server?
The server provides five tools: create_form, add_text_question, add_multiple_choice_question, get_form, and get_form_responses.
What are the prerequisites for running this server?
You need Node.js, a Google Cloud project with the Forms API enabled, OAuth 2.0 credentials, and a refresh token obtained from the setup script.
