Skip to main content
Glama

MCP Google Maps MCP-Google-Maps

A Model Context Protocol (MCP) server for Google Maps functionality, providing access to places search, geocoding, directions, and more through the MCP interface.

基于原项目: 此项目基于 ArtixZ/MCP-Google-Maps 修改而来

Features

  • Places Search

  • Place Details

  • Geocoding and Reverse Geocoding

  • Distance Matrix

  • Directions

  • Elevation Data

  • Static Maps Generation

Related MCP server: Google Places MCP Server

Installation & Testing

Requires Node.js 18 or newer (the bundled MCP SDK does not support older versions).

First, install the package globally:

npm install -g @bachstudio/mcp-google-maps

You can test if the MCP server is working by running:

npx bachstudio-mcp-google-maps

MCP Configuration

To use this with your MCP client, add the following to your MCP configuration:

{
    "mcpServers": {
        "google-maps": {
            "command": "npx",
            "args": ["-y", "@bachstudio/mcp-google-maps"],
            "env": {
                "GOOGLE_MAPS_API_KEY": "your_api_key_here",
                "DEFAULT_LANGUAGE": "en",
                "DEFAULT_REGION": "US"
            },
            "enabled": true
        }
    }
}

Note: this server does not cache responses or throttle requests — every tool call is sent to the Google Maps Platform and billed against your key. To cap cost, set quotas for the key in the Google Cloud console.

Available MCP Commands

The following commands are available through the MCP interface:

  • search_nearby: Search for places near a location

  • get_place_details: Get detailed information about a specific place

  • get_geocode: Convert address to coordinates

  • get_reverse_geocode: Convert coordinates to address

  • get_distance_matrix: Calculate distances between multiple origins and destinations

  • get_directions: Get directions between two points

  • get_elevation: Get elevation data for locations

  • get_map_with_directions: Generate map visualizations with directions, waypoints, and static map images

License

MIT

Author

bachstudio

Credits

Based on the original project by artixz

Available Tools

8 tools
get_directionsGet DirectionsC

Get directions between two locations

Inputs: origin (required), destination (required), mode.

get_distance_matrixDistance MatrixB

Calculate distance and time between multiple origins and destinations

Inputs: origins (required), destinations (required), mode.

get_elevationGet ElevationC

Get elevation data for locations

Inputs: locations (required).

get_geocodeGeocode AddressC

Convert an address to coordinates

Inputs: address (required).

get_map_with_directionsMap with DirectionsC

Generate a static map with directions overlay

Inputs: origin (required), destination (required), waypoints, mode, +3 more.

get_place_detailsGet Place DetailsB

Get detailed information about a specific place

Inputs: placeId (required).

get_reverse_geocodeReverse GeocodeB

Convert coordinates to an address

Inputs: latitude (required), longitude (required).

search_nearbySearch Nearby PlacesC

Search for places near a specific location

Inputs: center (required), keyword, radius, openNow, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity. For example, get_directions is for routing, get_distance_matrix is for multi-point calculations, and get_geocode vs get_reverse_geocode handle opposite conversions. The descriptions reinforce these unique functions, making tool selection straightforward.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with 'get_' or 'search_' prefixes, such as get_directions, get_geocode, and search_nearby. This uniformity enhances readability and predictability, allowing agents to easily understand the tool set's structure.

    Tool Count5/5

    With 8 tools, the count is well-scoped for a Google Maps server, covering core functionalities like directions, geocoding, place search, and maps. Each tool earns its place by addressing a specific aspect of location-based services without redundancy or bloat.

    Completeness5/5

    The tool set provides complete coverage for the Google Maps domain, including routing (directions, distance matrix), geospatial conversions (geocode, reverse geocode), place information (details, nearby search), and visualization (map with directions). No obvious gaps exist, enabling agents to handle typical mapping workflows effectively.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers