Google Calendar - No deletion
This server provides a secure way to manage Gmail and Google Calendar activities programmatically, with no calendar deletion capabilities.
Gmail Tools:
List recent emails with optional filtering
Search emails using advanced Gmail query syntax
Send new emails with CC and BCC support
Modify email labels (archive, trash, mark read/unread)
Calendar Tools:
List upcoming calendar events with date range filtering
Create new calendar events with attendees
Suggest available meeting slots within the next 30 days
Provides tools for listing, searching, sending, and modifying emails with support for filtering, Gmail query syntax, and label management.
Enables listing upcoming calendar events with date filtering and creating new calendar events with attendees (note: update and delete functionality has been removed for security reasons).
Click on "Deploy 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 Calendar - No deletion create a team meeting tomorrow at 2pm"
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
A Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.
Features
Gmail Tools
list_emails: List recent emails from your inbox with optional filteringsearch_emails: Advanced email search with Gmail query syntaxsend_email: Send new emails with support for CC and BCCmodify_email: Modify email labels (archive, trash, mark read/unread)
Calendar Tools
list_events: List upcoming calendar events with date range filteringcreate_event: Create new calendar events with attendeesThe events below were removed from this server for security measures since Google Cloud Calendar API does not have a scope that allows creation but prevents deletion or updates.
update_event: Update existing calendar eventsdelete_event: Delete calendar events
Related MCP server: google-workspace-mcp-server
Prerequisites
Node.js: Install Node.js version 14 or higher
Google Cloud Console Setup:
Go to Google Cloud Console
Create a new project or select an existing one
Enable the Gmail API and Google Calendar API:
Go to "APIs & Services" > "Library"
Search for and enable "Gmail API"
Search for and enable "Google Calendar API"
Set up OAuth 2.0 credentials:
Go to "APIs & Services" > "Credentials"
Click "Create Credentials" > "OAuth client ID"
Choose "Web application"
Set "Authorized redirect URIs" to include:
http://localhost:4100/codeNote down the Client ID and Client Secret
Setup Instructions
Installing via Smithery
To install Google Workspace Server - No Calendar Deletion for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @erickva/google-workspace-mcp-server-no-calendar-deletetion --client claudeInstalling Manually
Clone and Install:
git clone https://github.com/epaproditus/google-workspace-mcp-server.git cd google-workspace-mcp-server npm installCreate OAuth Credentials: Create a
credentials.jsonfile in the root directory:{ "web": { "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET", "redirect_uris": ["http://localhost:4100/code"], "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://oauth2.googleapis.com/token" } }Get Refresh Token:
node get-refresh-token.jsThis will:
Open your browser for Google OAuth authentication
Request the following permissions:
https://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/gmail.send
Save the credentials to
token.jsonDisplay the refresh token in the console
Configure MCP Settings: Add the server configuration to your MCP settings file:
For VSCode Claude extension:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonFor Claude desktop app:
~/Library/Application Support/Claude/claude_desktop_config.json
Add this to the
mcpServersobject:{ "mcpServers": { "google-workspace": { "command": "node", "args": ["/path/to/google-workspace-server/build/index.js"], "env": { "GOOGLE_CLIENT_ID": "your_client_id", "GOOGLE_CLIENT_SECRET": "your_client_secret", "GOOGLE_REFRESH_TOKEN": "your_refresh_token" } } } }Build and Run:
npm run build
Usage Examples
Gmail Operations
List Recent Emails:
{ "maxResults": 5, "query": "is:unread" }Search Emails:
{ "query": "from:example@gmail.com has:attachment", "maxResults": 10 }Send Email:
{ "to": "recipient@example.com", "subject": "Hello", "body": "Message content", "cc": "cc@example.com", "bcc": "bcc@example.com" }Modify Email:
{ "id": "message_id", "addLabels": ["UNREAD"], "removeLabels": ["INBOX"] }
Calendar Operations
List Events:
{ "maxResults": 10, "timeMin": "2024-01-01T00:00:00Z", "timeMax": "2024-12-31T23:59:59Z" }Create Event:
{ "summary": "Team Meeting", "location": "Conference Room", "description": "Weekly sync-up", "start": "2024-01-24T10:00:00Z", "end": "2024-01-24T11:00:00Z", "attendees": ["colleague@example.com"] }
3. Update Event:
{
"eventId": "event_id",
"summary": "Updated Meeting Title",
"location": "Virtual",
"start": "2024-01-24T11:00:00Z",
"end": "2024-01-24T12:00:00Z"
}4. Delete Event:
{
"eventId": "event_id"
}Troubleshooting
Authentication Issues:
Ensure all required OAuth scopes are granted
Verify client ID and secret are correct
Check if refresh token is valid
API Errors:
Check Google Cloud Console for API quotas and limits
Ensure APIs are enabled for your project
Verify request parameters match the required format
License
This project is licensed under the MIT License.
Available Tools
7 toolscreate_eventC
Create a new calendar event
Inputs: end (required), start (required), summary (required), attendees, +2 more.
list_emailsB
List recent emails from Gmail inbox
Inputs: maxResults, query.
list_eventsC
List upcoming calendar events
Inputs: maxResults, timeMax, timeMin.
meeting_suggestionC
Suggest available meeting slots within the next 30 days
Inputs: bankHolidays, calendarIds, daysToSearch, meetingLengthMinutes, +4 more.
modify_emailA
Modify email labels (archive, trash, mark read/unread)
Inputs: id (required), addLabels, removeLabels.
search_emailsC
Search emails with advanced query
Inputs: query (required), maxResults.
send_emailC
Send a new email
Inputs: body (required), subject (required), to (required), bcc, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
The tool set mixes calendar and email operations without clear boundaries, causing potential misselection. For example, 'list_emails' and 'search_emails' overlap in purpose for email retrieval, while calendar tools like 'create_event' and 'list_events' are distinct but the server's dual-domain focus creates confusion.
Naming conventions are mixed, with some tools using verb_noun patterns like 'create_event' and others using noun_verb like 'meeting_suggestion'. While readable, the inconsistency in structure (e.g., 'modify_email' vs. 'send_email') deviates from a predictable pattern.
With 7 tools, the count is reasonable, but it feels borderline due to the server's split focus on both Google Calendar and Gmail. This scope might be too broad for the limited tool set, leading to a thin coverage in each domain.
For the implied dual-domain purpose, there are significant gaps. In calendar, tools lack update or delete event operations, and in email, there's no way to delete emails or manage drafts. The server name suggests calendar focus, but email tools are included without full lifecycle coverage.
Maintenance
Related MCP Connectors
Streamable HTTP MCP server for Google Calendar and Sheets with OAuth login.
A MCP server that works with Google Calendar to manage event listing, reading, and updates.
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Related MCP Servers
- AlicenseBqualityAmaintenanceGoogle Workspace MCP Server11872,429 PyPI3,522PythonMIT
- AlicenseAqualityDmaintenanceMCP server for Google Workspace APIs - Docs, Sheets, Drive, Gmail, and Calendar. Enables reading, creating, and editing Google Docs and Sheets, managing comments, reading emails, and viewing calendar events.3453 npm17MIT
- AlicenseBqualityDmaintenanceProduction-ready MCP server for Google Workspace providing broad coverage across Gmail, Drive, Calendar, Docs, Sheets, and more, with safe-by-default write operations and markdown-to-Google-Docs support.10035 PyPIMIT
- AlicenseDqualityDmaintenanceMCP server for interacting with Google Calendar, enabling reading events from public calendars and, with OAuth, creating, updating, and deleting events.1ISC