Google Workspace MCP Server

What is Google Workspace MCP Server?

A Model Context Protocol (MCP) server for interacting with Google Workspace APIs including Gmail, Drive, Calendar, Docs, Sheets, and Slides. It provides tools and resources to manage these services using OAuth2 authentication.

How to use Google Workspace MCP Server?

Install Node.js 16+, set up a Google Cloud project with the necessary APIs enabled, and obtain OAuth 2.0 client credentials. Copy .env.example to .env, fill in your CLIENT_ID, CLIENT_SECRET, REDIRECT_URI, and REFRESH_TOKEN, then run npm run dev to start the server. Use npm run inspect to test tools and resources with the MCP Inspector.

Key features of Google Workspace MCP Server

• Gmail API: send emails, list messages, manage labels
• Drive API: list files, create folders, upload files
• Docs API: create and edit Google Docs
• Sheets API: read and write spreadsheet data
• Slides API: create presentations and slides
• Calendar API: list and create calendar events
• OAuth2 authentication flow helpers

Use cases of Google Workspace MCP Server

—

FAQ from Google Workspace MCP Server

What are the prerequisites?

Node.js 16+ and a Google Cloud project with the necessary APIs enabled and OAuth 2.0 client credentials.

How do I authenticate?

Use the generate_auth_url tool to get an authorization URL, open it in a browser to authorize, then use exchange_code_for_tokens with the returned authorization code to obtain a refresh token. Add the refresh token to your .env file.

Which Google Workspace APIs are supported?

Gmail, Drive, Calendar, Docs, Sheets, and Slides. Each has a set of dedicated tools and resources.

How do I start the server?

After configuration, run npm run dev to start the server. For testing, run npm run inspect to open the MCP Inspector in your browser.