cablate/mcp-google-map

View on GitHub ↗

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

428 ★81 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
Stars
428★
Forks
81
Language
TypeScript
License
MIT
Created
2025-02-22
Last push
2026-08-16