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.
Related MCP Servers
- FlicenseBqualityDmaintenanceA server that enables Cursor users to view, create, and manage Google Calendar events through natural language commands using the MCP protocol with Google OAuth2 authentication.Last updated5
- Flicense-qualityDmaintenanceA locally-hosted MCP server that integrates Gmail, Google Calendar, and Google Drive to provide AI-powered management of emails, events, and files. It enables tool-based interactions like sending emails, creating calendar events, and searching Drive files through clients like Cursor and Claude Desktop.Last updated
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that connects AI agents to Google Workspace (Gmail, Calendar, Drive, Docs, Sheets, and Slides).Last updated302MIT
- FlicenseBqualityAmaintenanceMCP server integrating multiple Google Workspace services including Gmail, Calendar, Drive, Sheets, Docs, Tasks, People, Forms, and Slides, enabling users to manage emails, events, files, documents, and more through natural language.Last updated15
Related MCP Connectors
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
GibsonAI MCP server: manage your databases with natural language
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- 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