mcp_google_froms

This MCP Server uses the Google Forms API to provide functionalities such as creating, editing forms, and retrieving responses. ## Build Method ### Initial Setup After cloning the repository, install the dependencies ``` cd google-forms-server npm install ``` ### Build the Server ``` # Build the main MCP Server npm run build ``` ### Build the Refresh Token Retrieval Script ``` # Build the refresh token retrieval script npm run build:token ``` ### Running in Development Environment ``` # Run the server directly node build/index.js # Or, use npm script npm run start ``` ## Setup Method 1. Create a project in Google Cloud Console and enable the Google Forms API. - https://console.cloud.google.com/ - Search for and enable the "Google Forms API" from API & Services > Library. 2. Obtain the OAuth 2.0 Client ID and Secret. - API & Services > Credentials > Create Credentials > OAuth Client ID - Application type: Select "Desktop app". 3. Set environment variables to obtain the refresh token. ```bash export GOOGLE_CLIENT_ID="Your Client ID" export GOOGLE_CLIENT_SECRET="Your Client Secret" cd google-forms-server npm run build node build/get-refresh-token.js ``` Note: If you encounter an error when running get-refresh-token.js, please execute the following command. ```bash cd google-forms-server npm run build:token node build/get-refresh-token.js ``` 4. Copy the displayed refresh token. 5. Update the configuration file for Claude's desktop application. - Open `~/Library/Application Support/Claude/claude_desktop_config.json`. - Add the environment variables to the `google-forms-server` section of `mcpServers`: ```json "google-forms-server": { "command": "node", "args": [ "/Users/nakamotomasatoshi/application/AI/mcp-google-form/google-forms-server/build/index.js" ], "env": { "GOOGLE_CLIENT_ID": "Your Client ID", "GOOGLE_CLIENT_SECRET": "Your Client Secret", "GOOGLE_REFRESH_TOKEN": "Obtained Refresh Token" } } ``` 6. Restart the Claude desktop application. ## Available Tools This MCP Server provides the following tools: 1. `create_form` - Creates a new Google Form 2. `add_text_question` - Adds a text question to the form 3. `add_multiple_choice_question` - Adds a multiple-choice question to the form 4. `get_form` - Retrieves the details of the form 5. `get_form_responses` - Retrieves the responses of the form ## Usage Example ``` Please create a form and add some questions. ``` Claude will use the following MCP tools to create the form: 1. Use the `create_form` tool to create a new form 2. Use the `add_text_question` or `add_multiple_choice_question` tools to add questions 3. Display the URL of the created form