# cablate/mcp-google-map [Health: Active]

**Category:** 🗺️ Location Services  
**Repository:** https://github.com/cablate/mcp-google-map  
**GitHub Stars:** 445  
**npm Downloads (last month):** 4660  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/cablate-mcp-google-map

## Description
Google Maps MCP server with 8 tools (geocode, search, directions, elevation), stdio + StreamableHTTP transport, Agent Skill definitions, and standalone exec CLI mode.

## Tools
Capabilities this server exposes over MCP:

- **maps_search_nearby** — Find places near a location by type (restaurant, cafe, hotel, etc.). Supports filtering by radius, rating, and open status.
- **maps_search_places** — Free-text place search (e.g., "sushi restaurants in Tokyo"). Supports location bias, rating, open-now filters.
- **maps_place_details** — Get full details for a place by its place_id — reviews, phone, website, hours. Optional `maxPhotos` param returns photo URLs.
- **maps_geocode** — Convert an address or landmark name into GPS coordinates.
- **maps_reverse_geocode** — Convert GPS coordinates into a street address.
- **maps_distance_matrix** — Calculate travel distances and times between multiple origins and destinations. Driving mode supports `avoid_tolls` and `avoid_highways`.
- **maps_directions** — Get step-by-step navigation between two points with route details. Driving mode supports `avoid_tolls` and `avoid_highways`.
- **maps_elevation** — Get elevation (meters above sea level) for geographic coordinates.
- **maps_timezone** — Get timezone ID, name, UTC/DST offsets, and local time for coordinates.
- **maps_weather** — Get current weather conditions or forecast — temperature, humidity, wind, UV, precipitation.
- **maps_air_quality** — Get air quality index, pollutant concentrations, and health recommendations by demographic group.
- **maps_static_map** — Generate a map image with markers, paths, or routes — returned inline for the user to see directly.
- **maps_batch_geocode** — Geocode up to 50 addresses in one call — returns coordinates for each.
- **maps_search_along_route** — Search for places along a route between two points — ranked by minimal detour time.
- **maps_explore_area** — Explore what's around a location — searches multiple place types and gets details in one call.
- **maps_plan_route** — Plan an optimized multi-stop route — uses Routes API waypoint optimization (up to 25 stops) for efficient ordering. Driving mode supports `avoid_tolls` and `avoid_highways`.
- **maps_compare_places** — Compare places side-by-side — searches, gets details, and optionally calculates distances.
- **maps_local_rank_tracker** — Track a business's local search ranking across a geographic grid — like LocalFalcon. Supports up to 3 keywords for batch scanning. Returns rank at each point, top-3 competitors, and metrics (ARP, ATRP, SoLV).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-google-map": {
    "command": "npx",
    "args": ["-y","@cablate/mcp-google-map"],
    "env": {
      "GOOGLE_MAPS_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `GOOGLE_MAPS_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What cablate/mcp-google-map MCP server does

The cablate/mcp-google-map MCP server connects MCP-compatible clients to Google Maps-related operations. It covers address and coordinate conversion, place discovery, place details, navigation, travel-time calculations, elevation, time zones, weather, air quality, and static map images.

The tool set also includes higher-level workflows. Agents can explore an area across several place types, optimize a route with up to 25 stops, compare places, search for businesses along a route, or scan a geographic grid for local search rankings. The ranking tracker accepts up to three keywords and reports positions, top competitors, ARP, ATRP, and SoLV.

## How it works

Run the package locally with stdio for desktop clients, or start its Streamable HTTP transport for multi-session or remote access. In stdio mode, the MCP client starts the package and supplies the API key through its environment. HTTP deployments can receive a key through an HTTP header, a command-line option, or the server environment.

The package also supports an exec mode that invokes tools without starting an MCP server. Its batch geocoding command reads one address per line from a file or standard input and writes JSON results, with a default concurrency of 20 requests.

All listed tools are marked read-only and non-destructive. The project includes an Agent Skill definition describing how to use and chain the Google Maps tools.

## Setup and configuration

Install and run the cablate/mcp-google-map MCP server with the npm package command shown below:

```bash
npx -y @cablate/mcp-google-map --stdio
```

Configure `GOOGLE_MAPS_API_KEY` in the MCP client's environment. The key can also be passed to an HTTP server with `--apikey` or supplied per request using the `X-Google-Maps-API-Key` header. `GOOGLE_MAPS_ENABLED_TOOLS` can restrict registration to a comma-separated subset of tools; leaving it unset or using `*` enables all tools.

Before using place and routing features, enable Places API (New) and Routes API in Google Cloud Console. The README also documents `MCP_SERVER_PORT` and `MCP_SERVER_HOST` for HTTP configuration.

## Tools and capabilities

- Search nearby places by type, radius, rating, and open status.
- Search by free text and retrieve place details, reviews, contact data, hours, and photo URLs.
- Geocode addresses, reverse geocode coordinates, or process up to 50 addresses per tool call.
- Calculate distance matrices and step-by-step directions, including toll and highway avoidance for driving.
- Retrieve elevation, time-zone data, current or forecast weather, and air-quality information.
- Generate inline static map images with markers, paths, or routes.
- Search along routes, explore areas, optimize multi-stop routes, compare places, and track local rankings.

## Limitations and notes

This project relies on Google Maps APIs, so availability and applicable usage costs depend on the configured Google Cloud account and enabled APIs. The provided material does not specify API quotas or regional coverage. The local ranking tracker is described as a grid-based scan and not as a general analytics platform. HTTP mode requires choosing and configuring a host and port when deploying it for remote access.

_Full upstream README: https://allmcps.com/mcp/cablate-mcp-google-map/readme_