Welcome to the Gmail & Calendar MCP Server! This is a Model Completion Protocol (MCP) server designed to interact seamlessly with the Gmail and Google Calendar APIs, empowering Claude to read and manage emails and calendar events from your Google account. 🚀
📜 Summary of Project
A simple MCP server for gmail, google calendar, and google contacts (people)
—
The MCP Server is built on Rust, providing a robust and efficient interface to the Google APIs. Through this server, users can perform various functionalities like:
Listing emails from their inbox 📬
Searching for emails using Gmail search queries 🔍
Getting details of specific emails 📑
Analyzing email content for action items, meetings, contacts, and more 📊
Batch analyzing multiple emails for quick triage 📋
Listing all email labels 🏷️
Checking connection status with the Gmail API 📡
Listing available calendars 📅
Retrieving calendar events 🗓️
Getting details of specific calendar events 🎯
Creating new calendar events 📝
Listing contacts from Google Contacts 👤
Searching for contacts by name, email, or other attributes 🔎
Getting detailed information about specific contacts 📇
This server enhances Claude's email and calendar management capabilities with specialized prompts for email analysis, summarization, task extraction, meeting detection, contact extraction, prioritization, and more.
⚙️ How to Use
To utilize the Gmail MCP Server, follow these steps:
1. Create a Google Cloud Project and Enable the Gmail API
"Search for emails from example.com sent this year"
"Get the details of email with ID 18c1eab45a2d0123"
"Analyze this email for action items and deadlines"
"Extract meeting details from these emails"
"Summarize these 3 emails for me"
"Find all contact information in this email"
"Help me prioritize these emails"
Calendar Requests
"Show me all my calendars"
"List my upcoming events for next week"
"Show me details for the team meeting on Friday"
"Create a new meeting titled 'Project Review' for tomorrow at 2pm with [email protected]"
"What events do I have scheduled between April 1 and April 15?"
"Schedule a doctor's appointment for next Monday at 10am"
Contact Requests
"List my contacts"
"Find contacts named Smith"
"Search for contacts at example.com"
"Show me details for contact with ID people/c12345678901234567"
"Find contact information for John Doe"
📝 Advanced Email Analysis
The Gmail MCP Server provides specialized analysis capabilities through a set of custom prompts that help Claude understand and extract insights from emails:
Analysis Types
General Email Analysis: Comprehensive analysis of email content, context, tone, and next steps
Task Extraction: Identifies explicit and implicit action items, deadlines, and responsibilities
Meeting Detection: Extracts meeting details including date, time, location, participants, and agenda items
Contact Extraction: Identifies and formats contact information from email content
Email Summarization: Creates concise summaries of emails based on their length and complexity
Email Categorization: Classifies emails into categories like Action Required, FYI, Follow-up, etc.
Email Prioritization: Assesses urgency and importance of emails for better inbox management
Email Drafting Assistance: Guidelines for writing effective emails for different purposes
These analysis features help users quickly understand email content, extract important information, and take appropriate actions without having to read through lengthy messages.
🔧 Tech Info
Language: Rust
Primary Dependencies:
mcp-attr - For MCP server implementation
tokio - Asynchronous runtime
reqwest - HTTP client for Google APIs
serde and serde_json - For JSON serialization
dotenv - For environment variable management
log, simplelog, and chrono - For logging functionality
uuid - For generating unique request IDs
chrono - For datetime handling
Testing: Includes a comprehensive suite of unit and integration tests to ensure reliability and performance.
📅 Calendar Management
The Google Calendar integration provides a set of tools to manage your calendar events through Claude:
Calendar Features
List Calendars: View all calendars you have access to
List Events: Get events from any calendar with optional filtering by date range
Get Event Details: Retrieve complete information about a specific event
Create Events: Schedule new events with titles, descriptions, times, locations, and attendees
Calendar Permissions
The Calendar API uses the same OAuth credentials as the Gmail API, but requires the following additional scopes:
https://www.googleapis.com/auth/calendar.readonly (for reading calendars and events)
https://www.googleapis.com/auth/calendar (for creating and modifying events)
You can modify your OAuth consent screen to include these scopes when setting up your Google Cloud project.
👤 Contact Management
The Google People API integration provides tools to access and search your contacts:
Contact Features
List Contacts: View all contacts in your Google Contacts with optional limit
Search Contacts: Find contacts by name, email, organization or other attributes
Get Contact Details: Retrieve complete information about a specific contact including name, emails, phone numbers, and organizations
Contact Permissions
The People API uses the same OAuth credentials as the Gmail API, but requires the following additional scope:
This scope gives read-only access to your contacts, allowing the MCP server to retrieve contact information without modifying your contact list.
Project Structure
src/
├── lib.rs # Main implementation including API clients and MCP server
├── main.rs # Command-line interface and server startup
├── config.rs # Configuration handling
├── gmail_api.rs # Gmail API client implementation
├── calendar_api.rs # Google Calendar API client implementation
├── people_api.rs # Google People API client implementation (contacts)
├── logging.rs # Logging setup
├── server.rs # MCP server implementation
└── prompts.rs # Email analysis prompts
tests/
└── integration_tests.rs # Integration tests for MCP commands
.env.example # Example environment variables
.gitignore # Git ignore configuration
Cargo.toml # Rust dependencies
mcp-test.sh # MCP test script
mise.toml # Development environment configuration
README.md # This file
test_mcp_server/ # Test utilities for the MCP server
Note:
Make sure to handle sensitive information with care as some files may contain credentials or tokens. Always refer to the official Gmail API documentation for the latest updates and practices.
Thank you for your interest in the Gmail MCP Server! If you have any questions or feedback, feel free to reach out or contribute to the repository! Happy coding! 🎉
🚀 Release Process
To create a new release:
Use the included script to bump the version:
# View current version
./trigger-release.sh version
# Bump patch version (0.1.0 -> 0.1.1)
./trigger-release.sh bump-patch
# Bump minor version (0.1.0 -> 0.2.0)
./trigger-release.sh bump-minor
# Bump major version (0.1.0 -> 1.0.0)
./trigger-release.sh bump-major
# Or set a specific version
./trigger-release.sh set-version 1.2.3
Commit the version change:
git add Cargo.toml
git commit -m "Bump version to X.Y.Z"
git push
Create and push a new tag to trigger the release workflow:
./trigger-release.sh tag-current
The GitHub Actions workflow will automatically:
Create a GitHub release
Build binaries for Windows, Linux, and macOS (Intel & Apple Silicon)
Attach binaries to the release
G
Gmailcal MCP Rs
2389-research·2 estrelas·
A simple MCP server for gmail, google calendar, and google contacts (people)
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Gmailcal MCP Rs?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Gmailcal MCP Rs precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Gmailcal MCP Rs usa?
Gmailcal MCP Rs roda localmente via stdio.
Quando Gmailcal MCP Rs foi verificado pela última vez?
Última verificação: 2026-10-26. A simple MCP server for gmail, google calendar, and google contacts (people)