Google Workspace MCP Server
@epaproditus
About Google Workspace MCP Server
A Model Context Protocol server for Google Workspace integration (Gmail and Calendar)
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"google-workspace-mcp-server": {
"command": "node",
"args": [
"get-refresh-token.js"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Google Workspace MCP Server?
A Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs. It enables managing emails and calendar events programmatically through the MCP interface.
How to use Google Workspace MCP Server?
Requires Node.js 14+, a Google Cloud project with Gmail API and Calendar API enabled, and OAuth 2.0 credentials. Clone the repository, install dependencies, create a credentials.json, run node get-refresh-token.js to get a refresh token, configure the MCP settings file with environment variables, then build and run.
Key features of Google Workspace MCP Server
- List, search, send, and modify Gmail emails
- List, create, update, and delete Calendar events
- Gmail email labeling (archive, trash, mark read/unread)
- Calendar event support for attendees and date filtering
- OAuth 2.0 authentication with refresh token
Use cases of Google Workspace MCP Server
- Automate email management: list unread, send, archive
- Search emails using Gmail query syntax
- Manage calendar events: create meetings with attendees
- Update or delete existing calendar events programmatically
FAQ from Google Workspace MCP Server
What prerequisites are required?
Node.js version 14 or higher, a Google Cloud project with the Gmail API and Calendar API enabled, and OAuth 2.0 credentials (Client ID, Client Secret).
How do I authenticate with Google?
You must create a credentials.json file and run node get-refresh-token.js, which opens a browser for OAuth consent. The refresh token is saved to token.json and displayed.
What Google OAuth scopes are requested?
The server requests https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/calendar, and https://www.googleapis.com/auth/gmail.send.
How is the server configured in an MCP host?
Add a configuration entry to your MCP settings file with the command node, the path to build/index.js, and environment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN.
What if I get API errors?
Check Google Cloud Console for API quotas/limits, ensure the Gmail and Calendar APIs are enabled for your project, and verify request parameters match the required format.
Frequently asked questions
What prerequisites are required?
Node.js version 14 or higher, a Google Cloud project with the Gmail API and Calendar API enabled, and OAuth 2.0 credentials (Client ID, Client Secret).
How do I authenticate with Google?
You must create a `credentials.json` file and run `node get-refresh-token.js`, which opens a browser for OAuth consent. The refresh token is saved to `token.json` and displayed.
What Google OAuth scopes are requested?
The server requests `https://www.googleapis.com/auth/gmail.modify`, `https://www.googleapis.com/auth/calendar`, and `https://www.googleapis.com/auth/gmail.send`.
How is the server configured in an MCP host?
Add a configuration entry to your MCP settings file with the command `node`, the path to `build/index.js`, and environment variables `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, and `GOOGLE_REFRESH_TOKEN`.
What if I get API errors?
Check Google Cloud Console for API quotas/limits, ensure the Gmail and Calendar APIs are enabled for your project, and verify request parameters match the required format.
Basic information
More Other MCP servers
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
Peekaboo MCP – lightning-fast macOS screenshots for AI agents
steipetePeekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
Comments