Provides comprehensive Gmail integration including sending emails, reading and searching messages, retrieving email details by ID, and managing Gmail labels
Provides access to Google Finance for stock search, market data, and financial news, plus Google Flights integration for airport search, flight pricing, and multi-city trip planning
Enables full calendar management including creating, reading, updating, and deleting events across multiple calendars, with support for event listing, filtering, and date range queries
Offers Google Maps and Places functionality including geocoding, places search, turn-by-turn directions, distance matrix calculations, and detailed place information retrieval
Google MCP Server
A comprehensive Model Context Protocol (MCP) server that provides access to Google services including Maps, Finance, Flights, Gmail, and Calendar through a unified API.
Features
πΊοΈ Google Maps & Places
Geocoding: Convert addresses to coordinates and vice versa
Places Search: Find businesses, landmarks, and points of interest
Directions: Get turn-by-turn directions between locations
Distance Matrix: Calculate travel time and distance between multiple points
Place Details: Get detailed information about specific places
π Google Finance
Stock Search: Search for stocks, indices, mutual funds, currencies, and futures
Market Data: Get current prices, movement, and market information
Financial News: Access top financial news related to securities
βοΈ Google Flights
Airport Search: Find flights and airport information
Flight Pricing: Get flight prices and insights
Multi-city Trips: Support for complex multi-destination journeys
π§ Gmail
Send Emails: Send emails with subject, body, CC, and BCC
Read Emails: List and search emails with Gmail query syntax
Email Details: Get full email content by message ID
Label Management: Access Gmail labels and organization
π Google Calendar
Event Management: Create, read, update, and delete calendar events
Multi-Calendar Support: Work with multiple calendars (Personal, Work, Travel)
Event Listing: List events with filters and date ranges
Calendar Management: List and access different calendars
Installation
Prerequisites
Node.js 18+
pnpm (recommended) or npm
Setup
Clone the repository:
git clone <repository-url> cd google-mcpInstall dependencies:
pnpm installBuild the project:
pnpm run build
MCP Client Integration
Install the server to your preferred MCP clients:
Configuration
Environment Variables
Create a .env.local
file in the project root with your Google API credentials:
Google API Setup
Google Maps API: Enable Maps, Places, and Directions APIs in Google Cloud Console
Gmail/Calendar: Set up OAuth 2.0 credentials and obtain refresh tokens
Finance/Flights: Uses Google's public APIs (no additional setup required)
Usage
Running the Server
Available Tools
Maps & Places
geocode
- Convert address to coordinatesreverse-geocode
- Convert coordinates to addressplaces-search
- Search for places by text queryget-directions
- Get directions between locationsdistance-matrix
- Calculate distances between multiple pointsplace-details
- Get detailed place information
Finance
finance-search
- Search stocks, currencies, and financial instruments
Flights
airports-search
- Search flights and airport information
Gmail
gmail-send-email
- Send emailsgmail-read-emails
- List/search emailsgmail-get-email
- Get specific email by IDgmail-get-labels
- List Gmail labels
Calendar
calendar-create-event
- Create new eventscalendar-list-events
- List events with filterscalendar-get-event
- Get specific event detailscalendar-update-event
- Update existing eventscalendar-delete-event
- Delete eventscalendar-list-calendars
- List available calendars
Development
Project Structure
Key Technologies
MCP SDK:
@modelcontextprotocol/sdk
for protocol implementationSchema Validation: Zod for runtime type checking
Google APIs: Official Google client libraries
TypeScript: Full type safety with ES2022 target
Transport: StdioServerTransport for MCP communication
Development Workflow
Make changes to TypeScript files in
src/
Build:
pnpm run build
Test:
pnpm start
Install to clients:
pnpm run install-server
Restart MCP clients to load changes
Adding New Tools
Define Zod schema for parameters
Implement handler function
Register tool in
src/index.ts
usingserver.tool()
Build and reinstall to test
Architecture
This MCP server follows these design patterns:
Modular Design: Each Google service is in its own module
Schema Validation: All parameters validated with Zod schemas
Error Handling: Comprehensive error handling with meaningful messages
Type Safety: Full TypeScript coverage with strict mode
Transport Agnostic: Uses MCP's standard transport layer
License
[License information]
Contributing
[Contribution guidelines]
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables interaction with multiple Google services including Maps, Finance, Flights, Gmail, and Calendar through a unified interface. Provides comprehensive access to geocoding, stock data, flight information, email management, and calendar operations.