google-workspace-mcp
Provides tools for managing Gmail messages, including searching, reading, sending, drafting, modifying labels, and downloading attachments.
Provides tools for managing Google Calendar events, including creating, updating, deleting, responding to events, and finding free time slots.
Provides tools for interacting with Google Chat, including listing spaces, sending messages, managing threads, and sending direct messages.
Provides tools for viewing and editing Google Docs, including reading, writing, replacing, and formatting text, and getting suggestions.
Provides tools for managing Google Drive files and folders, including searching, creating, moving, trashing, renaming, and downloading files, and retrieving comments.
Provides tools for reading Google Sheets data, including getting cell text, ranges, finding values, and retrieving metadata.
Provides tools for reading Google Slides content, including getting text, finding items, retrieving metadata, images, and slide thumbnails.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-workspace-mcpFind emails from last week about the project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Google Workspace MCP Server for Cursor
An MCP (Model Context Protocol) server that provides Cursor with tools to interact with Google Workspace: Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat, and People.
Repository: github.com/Dave-Nguyen-PM/google-workplace-mcp
Prerequisites
Node.js >= 20
A Google Cloud project with OAuth 2.0 credentials
Related MCP server: Google MCP Server
GCP Setup
Go to Google Cloud Console
Create a new project (or use an existing one)
Enable these APIs:
Gmail API
Google Calendar API
Google Drive API
Google Docs API
Google Sheets API
Google Slides API
Google Chat API
People API
Go to APIs & Services > OAuth consent screen and configure it
Go to APIs & Services > Credentials and create an OAuth 2.0 Client ID (type: Desktop app)
Download the JSON file
Installation
cd /path/to/google-workplace-mcp
npm install
npm run buildConfiguration
Place the downloaded OAuth credentials file in one of these locations:
./credentials.jsonin the project root~/.google-workspace-mcp/credentials.jsonSet
GOOGLE_CREDENTIALS_PATHenvironment variable
Add to your Cursor MCP settings (~/.cursor/mcp.json):
{
"mcpServers": {
"google-workspace": {
"command": "node",
"args": ["/path/to/google-workplace-mcp/dist/index.js"],
"env": {
"GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json"
}
}
}
}First Run
On the first request that requires Google auth, a browser window will open for OAuth consent. After authorizing, tokens are cached at ~/.google-workspace-mcp/tokens.json and auto-refreshed.
Tools (57 total)
Domain | Tools | Access |
Auth |
| - |
Time |
| Read |
Drive |
| Read/Write |
Docs |
| Read/Write |
Sheets |
| Read |
Slides |
| Read |
Calendar |
| Read/Write |
Gmail |
| Read/Write |
Chat |
| Read/Write |
People |
| Read |
Debug Mode
Run with --debug to enable file logging to ~/.google-workspace-mcp/debug.log:
{
"mcpServers": {
"google-workspace": {
"command": "node",
"args": ["/path/to/dist/index.js", "--debug"]
}
}
}Development
npm run dev # Watch mode (rebuilds on changes)
npm run build # Production build
npm start # Run the server directlyThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Dave-Nguyen-PM/google-workplace-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server