Google Maps MCP Server

cablate/mcp-google-map

The Mcp Google Map server provides AI agents with geospatial capabilities through 18 tools covering geocoding, place search, routing, elevation, distance matrix, timezone, weather, air quality, and map imagery, along with four composite tools for complex tasks like trip planning and location comparison. It operates in multiple modes (stdio, HTTP, and CLI) and includes built-in agent skill definitions to help AI models chain geographic operations together. The server solves the problem of giving language models practical understanding of the physical world by integrating Google Maps APIs in a structured, tool-based format that agents can reason about and utilize autonomously.

GitHub stars: 489
tools: 8
auth: Secret needed
transport: STDIO
env vars: 2
last updated: Sep 26, 2026

View on GitHub

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

GOOGLE_MAPS_COMPUTE_ROUTE_MATRIXCalculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes.7 params

Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes.

Parameters* required

destinationsarray

List of destination locations. Each can be specified as an address or latitude/longitude coordinates.

fieldMaskstring

Comma-separated list of response fields to include (e.g., 'originIndex,destinationIndex,duration,distanceMeters'). Use '*' for all fields.default: originIndex,destinationIndex,duration,distanceMeters,status,condition

languageCodestring

BCP-47 language code (e.g., 'en-US', 'es') for textual information.default: en-US

originsarray

List of origin locations. Each can be specified as an address or latitude/longitude coordinates.

routingPreferencestring

Specifies routing preference: `TRAFFIC_UNAWARE` (fastest, ignores traffic), `TRAFFIC_AWARE` (considers traffic, optimized), `TRAFFIC_AWARE_OPTIMAL` (most accurate traffic-based routing), or `ROUTIN...one of ROUTING_PREFERENCE_UNSPECIFIED · TRAFFIC_UNAWARE · TRAFFIC_AWARE · TRAFFIC_AWARE_OPTIMALdefault: TRAFFIC_AWARE

travelModestring

Mode of transportation for the route matrix calculation.one of DRIVE · BICYCLE · WALK · TWO_WHEELER · TRANSITdefault: DRIVE

unitsstring

Unit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances.one of METRIC · IMPERIALdefault: IMPERIAL

GOOGLE_MAPS_DISTANCE_MATRIX_APIDEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern 'Compute Route Matrix' action instead, which supports OAuth2 authentication. Supports different modes...13 params

DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern 'Compute Route Matrix' action instead, which supports OAuth2 authentication. Supports different modes...

Parameters* required

arrival_timeinteger

Specifies the desired time of arrival for transit directions, in seconds since midnight, January 1, 1970 UTC. You can specify either departure_time or arrival_time, but not both.

avoidstring

Indicates that the calculated route should avoid the specified features. Multiple values can be pipe-separated e.g. 'tolls|highways'.one of tolls · highways · ferries · indoor

departure_timeinteger

Specifies the desired time of departure. You can specify the time as an integer in seconds since midnight, January 1, 1970 UTC, or as the string 'now'. Required for duration_in_traffic.

destinationsstring

One or more locations to use as the finishing point for calculating travel distance and time. Accepts the same formats as origins.

keystring

Your application's API key. This key identifies your application for purposes of quota management.

languagestring

The language in which to return results. See the list of supported languages: https://developers.google.com/maps/faq#languagesupport

modestring

Specifies the mode of transport to use.one of driving · walking · bicycling · transitdefault: driving

originsstring

The starting point for calculating travel distance and time. You can supply one or more locations separated by the pipe character (|), in the form of a place ID (prefixed with place_id:), an addres...

regionstring

The region code, specified as a ccTLD ('top-level domain') two-character value. This helps influence results based on the region.

traffic_modelstring

Specifies the assumptions to use when calculating time in traffic. This parameter is only used if the request includes a departure_time and mode is 'driving'.one of best_guess · pessimistic · optimistic

transit_modestring

Specifies one or more preferred modes of transit. This parameter may only be specified for transit directions. Multiple values can be pipe-separated e.g. 'bus|train'.one of bus · subway · train · tram · rail

transit_routing_preferencestring

Specifies preferences for transit routes. This parameter may only be specified for transit directions.one of less_walking · fewer_transfers

unitsstring

Specifies the unit system to use when displaying results. The default is metric.one of metric · imperial

GOOGLE_MAPS_GEOCODING_APIDEPRECATED: Legacy API to convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. This API only works with API keys (no OAuth2 support). Consider using the modern Places API (Text Search or Ne...11 params

DEPRECATED: Legacy API to convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. This API only works with API keys (no OAuth2 support). Consider using the modern Places API (Text Search or Ne...

Parameters* required

addressstring

The street address or plus code that you want to geocode. Provide for geocoding (address to coordinates).

boundsstring

The bounding box of the viewport within which to bias geocode results more prominently (e.g., '34.172684,-118.604794|34.236144,-118.500938'). This parameter will only influence, not fully restrict,...

componentsstring

A components filter with elements separated by a pipe (|). E.g., 'postal_code:94043|country:US'. Used for geocoding, can be restrictive or biasing.

extra_computationsarray

Use this parameter to specify additional features in the response. Can select multiple values.

keystring

Your application's API key. If not provided, will be extracted from connection metadata.

languagestring

The language in which to return results. If language is not supplied, the geocoder attempts to use the preferred language as specified in the Accept-Language header, or the native language of the d...

latlngstring

The latitude and longitude coordinates specifying the location for which you want the closest, human-readable address (e.g., '40.714224,-73.961452'). Provide for reverse geocoding.

location_typestring

A filter of one or more location types, separated by a pipe (|) (e.g., 'ROOFTOP|RANGE_INTERPOLATED'). Used for reverse geocoding and place ID geocoding.

place_idstring

The place ID of the place for which you wish to obtain the human-readable address. Provide for place ID geocoding.

regionstring

The region code, specified as a ccTLD ('top-level domain') two-character value. This parameter will only influence, not fully restrict, results from the geocoder.

result_typestring

A filter of one or more address types, separated by a pipe (|) (e.g., 'street_address|locality'). Used for reverse geocoding and place ID geocoding.

GOOGLE_MAPS_GET_DIRECTIONDEPRECATED: Legacy API that fetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes. This API only works with API keys (no OAuth2 support). Use the modern 'Get Route' action instead, which supports OAuth2 auth...7 params

DEPRECATED: Legacy API that fetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes. This API only works with API keys (no OAuth2 support). Use the modern 'Get Route' action instead, which supports OAuth2 auth...

Parameters* required

avoidstring

Specifies features to avoid in the generated route. Multiple values can be combined using a pipe delimiter (e.g., 'tolls|highways'). Valid options include 'tolls', 'highways', and 'ferries'.

destinationstring

The ending point for the directions. This can be a textual address (e.g., '456 Park Ave, New York, NY'), a place name (e.g., 'Universal Studios Hollywood'), or latitude/longitude coordinates (e.g.,...

languagestring

The language code for returning results, e.g., 'en' for English, 'es' for Spanish. Defaults to 'en'.default: en

modestring

The mode of transportation for which to calculate directions. Supported values are 'driving' (default), 'walking', 'bicycling', and 'transit'.default: driving

originstring

The starting point for the directions. This can be a textual address (e.g., '123 Main St, Los Angeles, CA'), a place name (e.g., 'Disneyland'), or latitude/longitude coordinates (e.g., '34.0522,-11...

unitsstring

The unit system for displaying distances. Supported values are 'metric' (kilometers and meters) and 'imperial' (miles and feet). Defaults to 'imperial'.default: imperial

waypointsstring

A comma-separated string of intermediate locations (addresses, place names, or coordinates) to visit between the origin and destination.

GOOGLE_MAPS_GET_ROUTECalculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps.11 params

Calculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps.

Parameters* required

computeAlternativeRoutesboolean

Computes and returns alternative routes if true.default: false

destination_addressstring

Destination point address or place name for the route calculation.

fieldMaskstring

Comma-separated list of `Route` object fields to include in the response (e.g., 'routes.distanceMeters,routes.duration') for efficiency.default: routes.distanceMeters,routes.duration,routes.polyline.encodedPolyline

languageCodestring

BCP-47 language code (e.g., 'en-US', 'es') for textual information like navigation instructions.default: en-US

origin_addressstring

Starting point address or place name for the route calculation.

routeModifiers_avoidFerriesboolean

Attempts to avoid ferries if true.default: false

routeModifiers_avoidHighwaysboolean

Attempts to avoid highways if true.default: false

routeModifiers_avoidTollsboolean

Attempts to avoid toll roads if true.default: false

routingPreferencestring

travelModestring

Mode of transportation for the route.one of DRIVE · BICYCLE · WALK · TWO_WHEELER · TRANSITdefault: DRIVE

unitsstring

Unit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances.one of METRIC · IMPERIALdefault: IMPERIAL

GOOGLE_MAPS_MAPS_EMBED_APITool to generate an embeddable Google Map URL and HTML iframe code. Use when you need to display a map (place, view, directions, street view, search) on a webpage without JavaScript. Note: This API only works with API keys (no OAuth2 support). It generates embed URLs and does...6 params

Tool to generate an embeddable Google Map URL and HTML iframe code. Use when you need to display a map (place, view, directions, street view, search) on a webpage without JavaScript. Note: This API only works with API keys (no OAuth2 support). It generates embed URLs and does...

Parameters* required

directions_paramsobject

Parameters for 'directions' mode.

modestring

The mode of the embedded map.one of place · view · directions · streetview · search

place_paramsobject

Parameters for 'place' mode.

search_paramsobject

Parameters for 'search' mode.

streetview_paramsobject

Parameters for 'streetview' mode.

view_paramsobject

Parameters for 'view' mode.

GOOGLE_MAPS_NEARBY_SEARCHSearches for places (e.g., restaurants, parks) within a specified circular area, with options to filter by place types and customize the returned fields and number of results.7 params

Searches for places (e.g., restaurants, parks) within a specified circular area, with options to filter by place types and customize the returned fields and number of results.

Parameters* required

excludedTypesarray

Place types to exclude (e.g., 'cafe', 'store'); results matching any of these types are omitted. For supported types, see Google Maps Places API documentation.

fieldMaskstring

Comma-separated list of place fields for the response (e.g., 'places.displayName,places.formattedAddress'); use '*' for all fields.default: places.displayName

includedTypesarray

Place types to include (e.g., 'restaurant', 'park'); results will match at least one of these types. For supported types, see Google Maps Places API documentation.

latitudenumber

Latitude coordinate of the search center in decimal degrees.

longitudenumber

Longitude coordinate of the search center in decimal degrees.

maxResultCountinteger

Maximum number of search results to return (up to 20); the actual count may be lower.default: 10

radiusnumber

Radius of the circular search area in meters.

GOOGLE_MAPS_TEXT_SEARCHSearches for places on Google Maps using a textual query (e.g., "restaurants in London", "Eiffel Tower").3 params

Searches for places on Google Maps using a textual query (e.g., "restaurants in London", "Eiffel Tower").

Parameters* required

fieldMaskstring

Comma-separated list of place fields to return. Use `*` for all fields (not recommended for performance/cost). See Google Maps Places API documentation for field names.default: places.displayName,places.formattedAddress,places.priceLevel

maxResultCountinteger

Maximum number of place results to return (must be 1-20). Note: Google prefers `pageSize`, but this action uses `maxResultCount`.default: 10

textQuerystring

Text query for searching places. Matched against place name, address, and category.

Configuration

GOOGLE_MAPS_API_KEY*secret

Google Maps API key (get one at https://console.cloud.google.com)

GOOGLE_MAPS_ENABLED_TOOLS

Comma-separated tool names to enable. Omit or * for all 18 tools.

Readme

Google Maps for AI agents

Stop rebuilding place search, routing, and location workflows for every AI app.

@cablate/mcp-google-map turns Google Maps Platform into 18 read-only agent tools and three focused Skills. An agent can find real places, verify routes, compare options, build practical itineraries, or audit local search visibility—through MCP or a standalone CLI.

You choose the integration model: Codex or Claude Code Plugin when you want Skills without MCP setup, stdio for desktop MCP clients, or Streamable HTTP for shared and remote deployments.

English · 繁體中文

Google Maps tools and workflows for AI agents

View the full README on GitHub

Details

Repository: github.com/cablate/mcp-google-map
Category: Search & Web Crawling
Package: @cablate/mcp-google-map
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Search & Web Crawling MCP servers

View all

Sosuminshipster/sosumi.aiSearch and read Apple developer documentation, HIG, and WWDC transcripts as Markdown.485stars

Molio Knowledge Basezhuzhaoyun/molioRead-only access to your Molio local knowledge base: search, read, browse, and AI Q&A.443stars

Marm Mcp Serverlyellr88/marm-memoryUniversal MCP Server with advanced AI memory capabilities and semantic search.0stars

Nexusgrafbase/nexusUnifies multiple MCP servers and LLM providers behind a single endpoint for search and tool execution.427stars

ASTast-grep/ast-grep-mcpProvides AST-based code search and rule testing for AI assistants across codebases.403stars

Claude Skillsk-dense-ai/claude-skills-mcpMCP server for searching and retrieving Claude Agent Skills using vector search384stars