Google Maps MCP Server

Community

18 Google Maps tools for AI agents — geocode, route, search, and reason about locations.

How to install ↓ Compare GitHub source repository ↗

Category: Other
Stars: ★ 473 Very popular
Transport: stdio (local process) · Streamable HTTP
Runtime: Node.js
Credentials: API key / credential required
License: MIT
Last commit: 25 days ago
Tools: 18

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.

Strongest · Setup experience 13/20 Weakest · Reliability 6/20

Reliability

6/20

Security and permissions

12/20

Maintenance

12/20

Documentation

13/20

Setup experience

13/20

Why each score

Reliability 6/20: Only README and manifest were supplied; no source, CI workflow, or committed tests could verify the claimed 18 tools or handshake behavior. The happy path appears plausible but unverified, and there is a contradiction about the default transport (stdio vs Streamable HTTP). Error handling and edge cases lack evidence, so scored conservatively.
Security and permissions 12/20: No malware, credential theft, covert exfiltration, or destructive defaults appear in the supplied material; all tools are annotated read-only/non-destructive, and the API key is provided via env/CLI/header and marked secret. However the claims of server-side handling, per-session isolation, and Zod validation cannot be verified without source, and the exact data sent to Google APIs is not fully disclosed. No red line triggered, but full marks are not justified.
Maintenance 12/20: The repository is not archived, has an MIT license, a 0.0.53 version, and the README references a changelog, roadmap, contributing guide, and security reporting channel with clear ownership/contact info. However there is no verifiable evidence of commit/release dates, issue response, or dependency updates; stars are only a discovery signal and were not counted.
Documentation 13/20: The README covers installation, authentication via three API-key methods, tool listings, stdio/HTTP/exec examples, and some limits (50-address batch, 25 stops, 20 concurrency), and references layered docs (skills, project docs, security assessment). But there is no clear troubleshooting section, no pricing disclosure, and the referenced layered docs cannot be verified from supplied material.
Setup experience 13/20: Setup is described as a few clear steps: `npx` startup, an API-key environment variable, and ready-made JSON config for mainstream clients; it is cross-platform via Node.js. However, no CI or test execution evidence is available, the default transport description is inconsistent, and Google Cloud API enablement is an external dependency, so the score is capped conservatively at 13.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

AI agents requiring geospatial capabilities
Travel planning applications
Local search and logistics optimization
Local SEO analysis
Developers needing map visualization, route optimization

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.

Setup

Before you start

Runtime：Node.js

GOOGLE_MAPS_API_KEY requiredsecret Required Google Maps API key, created at https://console.cloud.google.com; enable Places API (New) and Routes API before using place and routing tools.

Other optional settings (1)

GOOGLE_MAPS_ENABLED_TOOLS optional Optional comma-separated tool names to register only a subset and reduce context usage; omit or set to * for all 18 tools.

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 --stdio with environment variable GOOGLE_MAPS_API_KEY.
Optionally set GOOGLE_MAPS_ENABLED_TOOLS to limit tools.
Alternatively, start an HTTP server with --port and --host flags.

claude_desktop_config.json

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

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-google-map",
        "--stdio"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add google-maps -e GOOGLE_MAPS_API_KEY=YOUR_API_KEY -- npx -y @cablate/mcp-google-map --stdio

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

maps_geocode, maps_directions, and other maps_* tools should appear in the client's tool list; asking to geocode 'Tokyo Tower' and getting coordinates back proves the connection. Note that Places API (New) and Routes API must be enabled in Google Cloud Console first.

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.

Things to try

Once connected, you can ask your AI assistant things like:

Convert the address of Tokyo Tower into GPS coordinates
Find cafes near Kobe rated 4+ that are open now
Plan an optimized multi-stop route from Osaka to Kyoto via Nara
What's the current weather and air quality in Tokyo?

Tools 18

maps_search_nearby read-only

Find places near a location by type (restaurant, cafe, hotel, etc.). Supports filtering by radius, rating, and open status.

maps_search_places read-only

Free-text place search (e.g., 'sushi restaurants in Tokyo'). Supports location bias, rating, open-now filters.

maps_place_details read-only

Get full details for a place by its place_id — reviews, phone, website, hours. Optional maxPhotos param returns photo URLs.

maps_geocode read-only

Convert an address or landmark name into GPS coordinates.

maps_reverse_geocode read-only

Convert GPS coordinates into a street address.

maps_distance_matrix read-only

Calculate travel distances and times between multiple origins and destinations. Driving mode supports avoid_tolls and avoid_highways.

maps_directions read-only

Get step-by-step navigation between two points with route details. Driving mode supports avoid_tolls and avoid_highways.

maps_elevation read-only

Get elevation (meters above sea level) for geographic coordinates.

Show 10 more tools

maps_timezone read-only

Get timezone ID, name, UTC/DST offsets, and local time for coordinates.

maps_weather read-only

Get current weather conditions or forecast — temperature, humidity, wind, UV, precipitation.

maps_air_quality read-only

Get air quality index, pollutant concentrations, and health recommendations by demographic group.

maps_static_map read-only

Generate a map image with markers, paths, or routes — returned inline for the user to see directly.

maps_batch_geocode read-only

Geocode up to 50 addresses in one call — returns coordinates for each.

maps_search_along_route read-only

Search for places along a route between two points — ranked by minimal detour time.

maps_explore_area read-only

Explore what's around a location — searches multiple place types and gets details in one call.

maps_plan_route read-only

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 read-only

Compare places side-by-side — searches, gets details, and optionally calculates distances.

maps_local_rank_tracker read-only

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).

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 Desktop

Cursor

VS Code

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

DuckDuckGo Search MCP Server 74 · B

MCP server providing web search and content fetching via DuckDuckGo

★ 1.5k · Tools 2 Compare with this →

Basic Memory 72 · B

Your AI never forgets again.

★ 4.3k · Tools 21 Compare with this →

Telegram MCP Server 70 · B

Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.

★ 1.8k · Tools 76 Compare with this →

Hostinger API MCP Server 70 · B

Official MCP server for Hostinger API.

★ 163 · Tools 100 Compare with this →

Compare with other MCP servers

Source revision bc2c31f2b45d Data synced 2026-10-19 Read the FMRS scoring method