Google Maps MCP server

CommunityCabLate321Config last verified Jun 1, 2026

A maintained community server that brings Google Maps geocoding, places, directions, and more into your agent.

Google Maps MCP Server (@cablate/mcp-google-map) is a maintained community Model Context Protocol server that wraps the Google Maps Platform APIs so an agent can reason about the physical world: geocode addresses to coordinates and back, search for nearby or named places, fetch place details, compute distance matrices and turn-by-turn directions, look up elevation, timezone, weather, and air quality, and render static map images. It exists because the original @modelcontextprotocol/server-google-maps reference server was deprecated, leaving directory authors needing a current, actively-released option for location work.

It runs locally over stdio via npx with the --stdio flag and reads a GOOGLE_MAPS_API_KEY from the environment (you can also pass it with --apikey). Before using the place and routing tools you must enable the Places API (New) and Routes API in the Google Cloud Console, since those are the upstream services it calls. Alongside fourteen atomic tools it ships four composite tools — explore an area, plan an optimized multi-stop route, compare places side by side, and track a business's local search ranking — that bundle several calls into one higher-level operation. It is MIT-licensed and shipped twenty-eight releases through v0.0.52 in April 2026, making it the practical canonical choice for Google Maps operations over MCP today.

Quick install

Copy-paste configs are provided for all 8 supported clients. Pick your client below.

Add to ~/.claude.json

~/.claude.json
json
{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-google-map",
        "--stdio"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
Or via CLI
bash
claude mcp add google-maps -- npx -y @cablate/mcp-google-map --stdio

Available tools

ToolDescription
maps_search_nearbyFinds places near a location, optionally filtered by type, keyword, radius, or minimum rating.
maps_search_placesPerforms a free-text place search across the Google Maps Places API.
maps_place_detailsRetrieves full details for a place by its place_id, including contact info, hours, and ratings.
maps_geocodeConverts an address or landmark name into latitude/longitude coordinates.
maps_reverse_geocodeConverts latitude/longitude coordinates into a street address.
maps_batch_geocodeGeocodes up to 50 addresses in a single call.
maps_distance_matrixCalculates travel distances and durations between sets of origins and destinations.
maps_directionsReturns step-by-step navigation directions between an origin and destination for a given travel mode.
maps_search_along_routeSearches for places of interest along a computed route.
maps_elevationReturns elevation data for one or more geographic coordinates.
maps_timezoneReturns the timezone ID, name, and UTC/DST offsets for a coordinate.
maps_weatherReturns current weather conditions or a forecast for a location.
maps_air_qualityReturns the air quality index and pollutant concentrations for a location.
maps_static_mapGenerates a static map image with optional markers, paths, or routes.
maps_explore_areaComposite tool that explores what is around a location by combining nearby search and place details.
maps_plan_routeComposite tool that plans an optimized multi-stop route across several waypoints.
maps_compare_placesComposite tool that compares multiple places side by side on attributes like rating, distance, and details.
maps_local_rank_trackerComposite tool that tracks a business's local search ranking across a grid of nearby points.

Required configuration

  • GOOGLE_MAPS_API_KEYRequired

    Google Maps Platform API key with Places API (New) and Routes API enabled. Can also be supplied via the --apikey flag.

What you can do with it

Ground an agent in real-world location data

Geocode an address, find what's nearby, and pull place details so the agent answers questions about the physical world instead of guessing coordinates or business hours.

Plan and compare routes

Compute directions and a distance matrix, then use the composite route planner to optimize a multi-stop trip and search for stops along the way.

FAQ

Is it free?
The server is open source under the MIT license and free to run, but it calls the Google Maps Platform APIs, which bill against your Google Cloud account beyond the monthly free usage allotment.
Does it support remote/OAuth?
No. It runs locally over stdio (it can also expose a streamable-HTTP endpoint via flags) and authenticates to Google with a GOOGLE_MAPS_API_KEY rather than OAuth.
Is this Google's official server?
No. It is an actively-maintained community project by CabLate, chosen here because the original @modelcontextprotocol/server-google-maps reference server was deprecated. Google's own Maps Platform MCP offering focuses on grounding code-assist answers in docs, not on geocoding and routing operations.
← Browse all maps-location servers