cablate/mcp-google-map

A powerful Model Context Protocol (MCP) server providing comprehensive Google Maps API integration with LLM processing capabilities.

415 ★78 forksTypeScriptUpdated 1mo ago

What you need to know

Google Maps MCP server giving AI agents geospatial tools — 18 tools (14 atomic + 4 composite) for geocoding, place search/details, routing, elevation, timezone, weather, air quality, static maps, and local-SEO rank tracking, with stdio, Streamable HTTP, and a standalone exec CLI.

Install

npx @cablate/mcp-google-map --stdio (MCP server; requires GOOGLE_MAPS_API_KEY)
Prerequisite: enable Places API (New) and Routes API in Google Cloud Console before using place/routing tools
HTTP server: npx @cablate/mcp-google-map --port 3000 --apikey "YOUR_API_KEY"

Usage

  • MCP config: {"mcpServers":{"google-maps":{"command":"npx","args":["-y","@cablate/mcp-google-map","--stdio"],"env":{"GOOGLE_MAPS_API_KEY":"..."}}}
  • Limit context: set GOOGLE_MAPS_ENABLED_TOOLS to a comma list (e.g. maps_geocode,maps_directions,maps_search_places); omit or * for all 18
  • Exec CLI without a server: npx @cablate/mcp-google-map exec geocode '{"address":"Tokyo Tower"}'
  • Batch geocode from file: npx @cablate/mcp-google-map batch-geocode -i addresses.txt -o results.json

Key features

  • 14 atomic tools: search_nearby, search_places, place_details, geocode/reverse_geocode, distance_matrix, directions, elevation, timezone, weather, air_quality, static_map, batch_geocode (up to 50), search_along_route
  • 4 composite tools: explore_area, plan_route (waypoint optimization up to 25 stops), compare_places, local_rank_tracker (local SEO grid ranking like LocalFalcon)
  • Built-in agent skill (skills/google-maps/) teaches chaining of geo tools
  • All tools annotated readOnlyHint:true / destructiveHint:false so MCP clients can auto-approve
  • 3 modes: stdio, Streamable HTTP, standalone exec CLI; per-request API-key isolation for HTTP multi-session deployments

Best for

AI-powered travel planning, logistics route optimization, real-estate/neighborhood analysis, and local SEO audits

Caveats

  • Requires Google Cloud API keys and enabling the (paid) Places API (New) and Routes API
  • Some tools (weather, air quality) are covered by Google Grounding Lite but the full toolset is not
  • HTTP mode binds all interfaces when --host 0.0.0.0 — use API-key isolation / DNS-rebinding protection for remote access
Platforms: Cross-platform (Node.js)Clients: Claude Desktop · Cursor · VS Code · Any stdio/HTTP MCP client
Documentation ↗

Reviewed 2026-08-07

Topics

agent-skillaiai-agentdivegeocodinggeospatialgoogle-mapgoogle-mapsmcpmcp-servermodel-context-protocolplaces-apistreamable-httptypescript
View on GitHub ↗
Stars
415★
Forks
78
Language
TypeScript
License
MIT
Created
2025-02-22
Last push
2026-07-08