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
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Figs, Relationship Expert
Figs O'Sullivan, LMFTCouples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep
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!
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
Comments