Google Workspace MCP Server
@trymeuj
About Google Workspace MCP Server
No overview available yet
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"gmail-mcp-server-3": {
"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?
It is a Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs, enabling programmatic management of emails and calendar events through the MCP interface.
How to use Google Workspace MCP Server?
Clone the repository, run npm install, then set up OAuth 2.0 credentials via Google Cloud Console. Run node get-refresh-token.js to obtain a refresh token, configure the MCP settings file with environment variables (GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN), build with npm run build, and then invoke tools through MCP.
Key features of Google Workspace MCP Server
- List recent emails with optional filtering
- Advanced email search using Gmail query syntax
- Send emails with support for CC and BCC
- Modify email labels (archive, trash, mark read/unread)
- List upcoming calendar events with date range filtering
- Create, update, and delete calendar events with attendees
Use cases of Google Workspace MCP Server
- Automate retrieving unread emails from your inbox
- Search for emails with attachments from specific senders
- Send programmatic emails with CC and BCC recipients
- Archive or mark emails read/unread in bulk
- Schedule and manage calendar events with attendees
FAQ from Google Workspace MCP Server
What are the prerequisites for setting up Google Workspace MCP Server?
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 (client ID and secret) with http://localhost:4100/code as an authorized redirect URI.
How do I obtain a refresh token?
Run node get-refresh-token.js in the project root. This opens a browser for Google OAuth authentication, requests the required scopes, saves credentials to token.json, and displays the refresh token in the console.
What OAuth scopes does the server request?
It requests https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/calendar, and https://www.googleapis.com/auth/gmail.send.
How do I configure the MCP settings for the server?
Add an entry to the mcpServers object in your MCP settings file (VSCode Claude extension or Claude desktop app), specifying the command node, the path to build/index.js, and environment variables for your Google client ID, client secret, and refresh token.
What should I do if I encounter authentication errors?
Verify that all required OAuth scopes are granted, that your client ID and secret are correct, and that the refresh token is still valid. Also check the Google Cloud Console for API quotas and ensure the Gmail and Calendar APIs are enabled.
Frequently asked questions
What are the prerequisites for setting up Google Workspace MCP Server?
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 (client ID and secret) with `http://localhost:4100/code` as an authorized redirect URI.
How do I obtain a refresh token?
Run `node get-refresh-token.js` in the project root. This opens a browser for Google OAuth authentication, requests the required scopes, saves credentials to `token.json`, and displays the refresh token in the console.
What OAuth scopes does the server request?
It requests `https://www.googleapis.com/auth/gmail.modify`, `https://www.googleapis.com/auth/calendar`, and `https://www.googleapis.com/auth/gmail.send`.
How do I configure the MCP settings for the server?
Add an entry to the `mcpServers` object in your MCP settings file (VSCode Claude extension or Claude desktop app), specifying the command `node`, the path to `build/index.js`, and environment variables for your Google client ID, client secret, and refresh token.
What should I do if I encounter authentication errors?
Verify that all required OAuth scopes are granted, that your client ID and secret are correct, and that the refresh token is still valid. Also check the Google Cloud Console for API quotas and ensure the Gmail and Calendar APIs are enabled.
Basic information
More Communication MCP servers
Mcp Telegram
dryeabMCP Server for Telegram
Discord MCP Server
hanwegMCP server for discord bot
Caulo
PatryCaulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au
MailStream
Sponge LabsThe first MCP server for physical mail. Give any MCP-compatible AI agent the ability to send real postcards and letters, verify addresses, manage mailing lists and artwork, and track direct mail campaigns. Remote Streama
MCP Teams Server
InditexTechAn MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.
Comments