google-maps/maps

MCP Server

Google Maps MCP Server - geocoding, navigation, location services

Google Maps MCP server. Geocoding, directions, distance matrix, elevation, places, timezone, weather, air quality, static map images, and composite tools (explore area, plan route, compare places, local rank tracking).

Replaces the deprecated @modelcontextprotocol/server-google-maps.

MCP Server

  • Package: @cablate/mcp-google-map
  • Transport: stdio (also supports streamable HTTP — we use stdio)
  • Command: npx -y @cablate/mcp-google-map --stdio

Authentication

Google Maps API key from Google Cloud Console.

VariableRequiredDescription
GOOGLE_MAPS_API_KEYYesAPI key with Places API (New), Geocoding, Directions, Distance Matrix, Elevation, Timezone, Weather, and Air Quality APIs enabled

Available Tools

ToolDescription
maps_search_nearbyNearby places by type with radius, rating, open-now filters
maps_search_placesNatural-language place search ("ramen in Tokyo")
maps_place_detailsFull details by place_id — reviews, phone, hours, photos
maps_geocodeAddress → GPS coordinates
maps_reverse_geocodeGPS coordinates → street address
maps_distance_matrixTravel distance/time between origin/destination sets
maps_directionsTurn-by-turn directions
maps_elevationElevation in meters for coordinates
maps_timezoneTimezone ID, offset, local time for coordinates
maps_weatherCurrent weather or forecast
maps_air_qualityAQI, pollutants, health recommendations
maps_static_mapMap image with markers/paths/routes
maps_batch_geocodeGeocode up to 50 addresses in one call
maps_search_along_routePlaces along a route, sorted by detour time
maps_explore_areaComposite: multi-type search + details around a location
maps_plan_routeComposite: geocode, optimize stop order, return directions
maps_compare_placesComposite: side-by-side place comparison
maps_local_rank_trackerGeographic grid rank tracking (ARP / ATRP / SoLV)

All tools are readOnlyHint: true / destructiveHint: false — clients may auto-approve.

Configuration Example

toml
[[mcp.servers]]
name = "google-maps"
type = "stdio"
command = "npx"
args = ["-y", "@cablate/mcp-google-map", "--stdio"]
timeout_seconds = 120
env = { GOOGLE_MAPS_API_KEY = "your-key" }
tools = []

Notes:

  • Enable Places API (New) in GCP before using place-search / place-details tools.
  • First launch downloads the package via npx — keep timeout_seconds ≥120 for cold caches.