Frequently Asked Questions (FAQ) about Google Workspace MCP Server

Q: What is an MCP Server? A: MCP stands for Model Context Protocol. It is an open protocol standardizing how applications provide context to Large Language Models (LLMs). An MCP server acts as a bridge, allowing AI models to access and interact with external data sources and tools, such as Gmail and Google Calendar.

Q: What does the Google Workspace MCP Server do? A: It enables AI agents to seamlessly interact with your Gmail and Google Calendar data. AI agents can list emails, search emails, send emails, modify email labels, list calendar events, and create calendar events. It facilitates automation and improves productivity by connecting AI with Google Workspace.

Q: What are the prerequisites for installing the Google Workspace MCP Server? A: You need Node.js version 14 or higher. You also need to set up a Google Cloud Console project, enable the Gmail API and Google Calendar API, and configure OAuth 2.0 credentials.

Q: How do I install the Google Workspace MCP Server? A: You can install it either via Smithery or manually. Smithery provides a streamlined installation process, while manual installation involves cloning the repository, installing dependencies, configuring OAuth credentials, and setting up the server in your MCP settings file.

Q: What is Smithery? A: Smithery is a tool that simplifies the installation of the Google Workspace MCP Server. It automates the process, making it easier and faster to set up the server.

Q: How do I install the server using Smithery? A: Run the command npx -y @smithery/cli install @erickva/google-workspace-mcp-server-no-calendar-deletetion --client claude in your terminal.

Q: What are the steps for manual installation? A: The manual installation involves cloning the repository, creating OAuth credentials, getting a refresh token, configuring MCP settings, and building and running the server.

Q: Where do I find the MCP settings file? A: The location of the MCP settings file depends on the client you are using. For VSCode Claude extension, it is located at ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json. For the Claude desktop app, it is located at ~/Library/Application Support/Claude/claude_desktop_config.json.

Q: How do I create OAuth credentials? A: Go to Google Cloud Console, create a new project or select an existing one, enable the Gmail API and Google Calendar API, and set up OAuth 2.0 credentials.

Q: What permissions are required for the Google Workspace MCP Server? A: The server requires the following permissions: https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/calendar, and https://www.googleapis.com/auth/gmail.send.

Q: What kind of Gmail operations can I perform? A: You can list recent emails, search emails, send emails, and modify email labels.

Q: What kind of Calendar operations can I perform? A: You can list calendar events and create calendar events.

Q: What do I do if I have authentication issues? A: Ensure that all required OAuth scopes are granted, verify that your client ID and secret are correct, and check if your refresh token is valid.

Q: What do I do if I encounter API errors? A: Check Google Cloud Console for API quotas and limits. Ensure that the APIs are enabled for your project and verify that the request parameters match the required format.

Q: Can I connect this server with UBOS? A: Yes, the Google Workspace MCP Server can be integrated with the UBOS platform, providing a comprehensive solution for building, deploying, and managing AI agents at scale.