- 18 tools — 14 atomic + 4 composite (explore-area, plan-route, compare-places, local-rank-tracker)
- 3 modes — stdio, StreamableHTTP, standalone exec CLI
- Agent Skill — built-in skill definition teaches AI how to chain geo tools (
skills/google-maps/)
vs Google Grounding Lite
| This project | Grounding Lite | |
|---|---|---|
| Tools | 18 | 3 |
| Geocoding | Yes | No |
| Step-by-step directions | Yes | No |
| Elevation | Yes | No |
| Distance matrix | Yes | No |
| Place details | Yes | No |
| Timezone | Yes | No |
| Weather | Yes | Yes |
| Air quality | Yes | No |
| Map images | Yes | No |
| Composite tools (explore, plan, compare) | Yes | No |
| Open source | MIT | No |
| Self-hosted | Yes | Google-managed only |
| Agent Skill | Yes | No |
Quick Start
# stdio (Claude Desktop, Cursor, etc.)
npx @cablate/mcp-google-map --stdio
# exec CLI — no server needed
npx @cablate/mcp-google-map exec geocode '{"address":"Tokyo Tower"}'
# HTTP server
npx @cablate/mcp-google-map --port 3000 --apikey "YOUR_API_KEY"
Special Thanks
Special thanks to @junyinnnn for helping add support for streamablehttp.
Available Tools
| Tool | Description |
|---|---|
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. |
| Composite Tools | |
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). |
All tools are annotated with readOnlyHint: true and destructiveHint: false — MCP clients can auto-approve these without user confirmation.
No comments yet.