Frequently Asked Questions about the Google Workspace MCP Server

Q: What is an MCP Server? A: MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. An MCP server acts as a bridge between AI models and external data sources, enabling AI agents to access and interact with information.

Q: What Google Workspace services does this MCP Server support? A: The current version supports Gmail and Google Calendar. It allows AI agents to read emails, send emails, modify email labels, list calendar events, create events, update events, and delete events.

Q: What are the prerequisites for using the Google Workspace MCP Server? A: You need Node.js (version 14 or higher), a Google Cloud Console project with the Gmail API and Google Calendar API enabled, and OAuth 2.0 credentials configured.

Q: How do I set up OAuth 2.0 credentials? A: In the Google Cloud Console, navigate to “APIs & Services” > “Credentials,” create an OAuth client ID for a “Web application,” and set “Authorized redirect URIs” to http://localhost:4100/code. Note down the Client ID and Client Secret.

Q: Where do I configure the MCP server settings? A: You need to add the server configuration to your MCP settings file. For VSCode Claude extension, this is typically ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json. For the Claude desktop app, it’s ~/Library/Application Support/Claude/claude_desktop_config.json.

Q: What permissions (scopes) are required for the Google OAuth authentication? A: The required permissions are https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/calendar, and https://www.googleapis.com/auth/gmail.send.

Q: I’m encountering authentication issues. What should I do? 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: How do I troubleshoot API errors? A: Check the Google Cloud Console for API quotas and limits, ensure that the APIs are enabled for your project, and verify that your request parameters match the required format.

Q: Where can I find the complete documentation for the Google Workspace MCP Server? A: Detailed setup instructions, usage examples, and troubleshooting tips are available in the project’s README file on GitHub.