Google Maps
About
An MCP server for interacting with the Google Maps API, designed for Google Cloud Run.
Details
- Author
- arunrajece
- Categories
- Search, Other, API
Jump to
Setup
Install Google Maps in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/arunrajece/google-maps-mcp-cloudrun
Follow the installation instructions in the repository README, then restart your MCP client.
A Google Maps Model Context Protocol (MCP) server designed for deployment on Google Cloud Run with public access. This server provides Google Maps functionality to Claude Desktop clients through a secure, rate-limited API.
- Route Calculation: Optimal driving routes with real-time traffic data
- Route Comparison: Compare multiple routing alternatives with different options
- Live Traffic: Current traffic conditions and travel time analysis
- Cost Estimation: Trip cost calculations including fuel and toll estimates
- Public Access: No authentication required for easy sharing
- Rate Limiting: 50 requests per hour per IP address
- Cloud Run Optimized: Designed for serverless deployment on GCP
- Google Cloud Platform account with billing enabled
- Google Cloud CLI (gcloud) installed and configured
- Node.js 18+ for local development
- Google Maps API key with required APIs enabled
Before deployment, enable these APIs in your GCP project:
- Directions API- For route calculations
- Geocoding API- For address resolution
- Maps JavaScript API- For polyline encoding (optional)
Enable APIs viaGoogle Cloud Consoleor CLI:
gcloud services enable directions-backend.googleapis.com gcloud services enable geocoding-backend.googleapis.com gcloud services enable maps-backend.googleapis.com
# Clone the repository git clone <your-repo-url> cd google-maps-mcp-cloudrun # Set your Google Maps API key export GOOGLE_MAPS_API_KEY="your-api-key-here" # Deploy using the provided script ./simple-deploy.sh your-gcp-project-id us-central1
After deployment, extract your service URL:
# Get the service URL SERVICE_URL=$(gcloud run services describe google-maps-mcp \ --region us-central1 \ --format="value(status.url)") echo "Your MCP Server URL: $SERVICE_URL/sse"
# Set your project gcloud config set project YOUR_PROJECT_ID # Enable required services gcloud services enable run.googleapis.com cloudbuild.googleapis.com # Deploy gcloud run deploy google-maps-mcp \ --source . \ --region us-central1 \ --platform managed \ --allow-unauthenticated \ --set-env-vars GOOGLE_MAPS_API_KEY="your-api-key-here" \ --memory 1Gi \ --cpu 1 \ --max-instances 10 \ --timeout 300 \ --port 8080
Add this configuration to your Claude Desktop settings:
{ "mcpServers": { "google-maps": { "command": "npx", "args": [ "-y", "mcp-remote", "https://YOUR-SERVICE-URL.run.app/sse" ] } } }
ReplaceYOUR-SERVICE-URL.run.appwith your actual Cloud Run service URL.
macOS:~/Library/Application Support/Claude/claude_desktop_config.json
Windows:%APPDATA%/Claude/claude_desktop_config.json
The MCP server provides these tools to Claude:
- calculate_route- Calculate optimal driving routes with traffic
- compare_routes- Compare multiple route alternatives
- get_live_traffic- Get current traffic conditions
- estimate_costs- Calculate trip costs (fuel + tolls)
- MCP Endpoint:https://your-service.run.app/sse
- Health Check:https://your-service.run.app/health
- Usage Stats:https://your-service.run.app/stats
# Install dependencies npm install # Copy environment template cp .env.example .env # Edit .env with your API key # GOOGLE_MAPS_API_KEY=your-api-key-here # Start development server npm run dev # Test locally npm test
# Error: Permission denied gcloud auth login gcloud config set project YOUR_PROJECT_ID
# Error: API not enabled gcloud services enable run.googleapis.com gcloud services enable cloudbuild.googleapis.com
- VisitGCP Billing Console
- Enable billing for your project
# Check API key restrictions in Console # Ensure Directions API and Geocoding API are enabled
# Check logs for errors gcloud run services logs read google-maps-mcp --region us-central1 --limit 50
- Each IP is limited to 50 requests per hour
- Check/statsendpoint for current usage
- Consider implementing user authentication for higher limits
- Monitor your Google Maps API usage inGCP Console
- Increase quotas if needed
- Consider implementing caching for repeated requests
# Test health endpoint curl "https://your-service.run.app/health" # Test stats endpoint curl "https://your-service.run.app/stats" # Test with Claude Desktop # Add the configuration and try asking Claude to calculate a route
- API key is stored as environment variable (secure)
- Service allows public access (no authentication required)
- Rate limiting prevents abuse (50 requests/hour per IP)
- No sensitive data is logged or stored
- Cloud Run: Pay-per-request pricing
- Google Maps API: Pay-per-API-call pricing
- Monitoring: Use GCP billing alerts to track costs
# Set up billing budget alerts in GCP Console # Billing > Budgets & Alerts
- Model Context Protocol (MCP)
- Google Cloud Run Documentation
- Google Maps Platform Documentation
- Claude Desktop MCP Configuration
- Cloud Run Troubleshooting
- Google Maps API Troubleshooting
- GCP Support
MIT License - see LICENSE file for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
Note: This server is designed for development and testing purposes. For production use with high traffic, consider implementing additional security measures and monitoring.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Unlock geospatial intelligence through Mapbox APIs like geocoding, POI search, directions, isochrones and more.
Free business data API and MCP server. Find restaurants, cafes, hotels, shops and 37+ business categories in any city worldwide. Uses OpenStreetMap data. No API key required. REST API + MCP Streamable HTTP endpoint.
Provides access to the Israeli transport API for geocoding and transit directions.
Provides geolocation and nearby POI (Point of Interest) information using the Gaode Map API.
Provides geocoding services by integrating with the Nominatim API.
STDIO-based MCP server for Google Maps Platform APIs
Provides directions, place search, and geocoding features using the Naver Maps API.
IP2Location.io API integration to retrieve the geolocation information for an IP address.
Search the web using Kagi's search API
Interact & query with Meilisearch (Full-text & semantic search API)
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
