Best for
- AI agents requiring geospatial capabilities
- Travel planning applications
- Local search and logistics optimization
- Local SEO analysis
- Developers needing map visualization, route optimization
G
Google Maps MCP Server
Community
18 Google Maps tools for AI agents — geocode, route, search, and reason about locations.
GitHub source repository ↗
56FMRS · C
This server is feature-rich, providing 18 Google Maps tools covering a wide range of geospatial needs. Supports multiple transports and CLI modes, with clear documentation and project structure. Note the requirement for a valid API key and API enablement. Non-official, community-maintained project.
A powerful Model Context Protocol (MCP) server providing comprehensive Google Maps API integration for AI agents. It offers 18 tools (14 atomic + 4 composite) covering geocoding, place search, directions, weather, air quality, and more. Supports stdio, Streamable HTTP, and standalone CLI exec modes. Includes a built-in Agent Skill definition for chaining geo tools.
Tools
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).
Setup
- Enable Places API (New) and Routes API in Google Cloud Console.
- Obtain a Google Maps API key.
- Configure your MCP client to use npx:
npx -y @cablate/mcp-google-map --stdiowith environment variableGOOGLE_MAPS_API_KEY. - Optionally set
GOOGLE_MAPS_ENABLED_TOOLSto limit tools. - Alternatively, start an HTTP server with
--portand--hostflags.
claude_desktop_config.json
{
"mcpServers": {
"google-maps": {
"command": "npx",
"args": ["-y", "@cablate/mcp-google-map", "--stdio"],
"env": {
"GOOGLE_MAPS_API_KEY": "YOUR_API_KEY"
}
}
}
}
Fit and risk
Not for
- Simple chatbots that don't need Google Maps features
- Deployments needing high-precision location but unwilling to rely on external API keys
- Use cases requiring real-time traffic flow, street view, or turn-by-turn mobile navigation (not provided)
- Scenarios needing official Google support, as this is a community project
Required permissions
- Requires a valid Google Maps API key (`GOOGLE_MAPS_API_KEY`), with Places API (New) and Routes API enabled.
- Server makes external network requests to Google Maps APIs.
- All tools are annotated with `readOnlyHint: true` and `destructiveHint: false` — MCP clients can auto-approve without user confirmation.
- Tool enabling can be filtered via `GOOGLE_MAPS_ENABLED_TOOLS` environment variable.
Risks and side effects
- API key leakage risk: handle carefully, do not commit to public repositories.
- Cost risk: high usage may incur charges on Google Cloud account; set quotas and budgets.
- Data privacy: addresses and coordinates sent to APIs may be sensitive.
- Tools are read-only but could be used for malicious tracking.
Troubleshooting
- If tool calls fail, check that the API key is valid and that Places API (New) and Routes API are enabled.
- Verify MCP client configuration and environment variables.
- If using HTTP mode, check port conflicts and host binding.
- Check server logs for detailed errors.
- If only partial tools are enabled, confirm `GOOGLE_MAPS_ENABLED_TOOLS` syntax.
Use cases
Travel planning: geocode → search → directions → weather.
Real estate analysis: nearby amenities, elevation, commute times.
Logistics optimization: efficient multi-stop delivery routing.
Field sales: visit clients and find lunch spots.
Disaster response: find nearest open hospitals, flood risk.
Content creation: analyze neighborhood characteristics.
Accessibility: find accessible restaurants, avoid steep routes.
Local SEO: analyze local rankings and competitors.
Supported clients
Claude DesktopFull support
CursorFull support
VS CodeFull support