Summary
Wraps the Google Maps API into seven tools covering the main location workflows: geocoding addresses to coordinates and back, searching for nearby places by type, pulling full place details including hours and reviews, getting turn-by-turn directions with multiple transit modes, calculating distance matrices between location pairs, and checking elevation data. Hosted through Pipeworx's gateway, so no API key setup required. You can call tools directly or use their ask_pipeworx natural language interface to query in plain English and let it route to the right endpoint. Useful when you're building location-aware features, need routing logic, or want to enrich data with geographic context without managing Maps API credentials yourself.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
8 tools
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
destinationsarrayList of destination locations. Each can be specified as an address or latitude/longitude coordinates.
fieldMaskstringComma-separated list of response fields to include (e.g., 'originIndex,destinationIndex,duration,distanceMeters'). Use '*' for all fields.default: originIndex,destinationIndex,duration,distanceMeters,status,condition
languageCodestringBCP-47 language code (e.g., 'en-US', 'es') for textual information.default: en-US
originsarrayList of origin locations. Each can be specified as an address or latitude/longitude coordinates.
routingPreferencestringSpecifies 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_AWAREtravelModestringMode of transportation for the route matrix calculation.one of
DRIVE · BICYCLE · WALK · TWO_WHEELER · TRANSITdefault: DRIVEunitsstringUnit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances.one of
METRIC · IMPERIALdefault: IMPERIALGOOGLE_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_timeintegerSpecifies 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.
avoidstringIndicates that the calculated route should avoid the specified features. Multiple values can be pipe-separated e.g. 'tolls|highways'.one of
tolls · highways · ferries · indoordeparture_timeintegerSpecifies 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.
destinationsstringOne or more locations to use as the finishing point for calculating travel distance and time. Accepts the same formats as origins.
keystringYour application's API key. This key identifies your application for purposes of quota management.
languagestringThe language in which to return results. See the list of supported languages: https://developers.google.com/maps/faq#languagesupport
modestringSpecifies the mode of transport to use.one of
driving · walking · bicycling · transitdefault: drivingoriginsstringThe 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...
regionstringThe region code, specified as a ccTLD ('top-level domain') two-character value. This helps influence results based on the region.
traffic_modelstringSpecifies 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 · optimistictransit_modestringSpecifies 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 · railtransit_routing_preferencestringSpecifies preferences for transit routes. This parameter may only be specified for transit directions.one of
less_walking · fewer_transfersunitsstringSpecifies the unit system to use when displaying results. The default is metric.one of
metric · imperialGOOGLE_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
addressstringThe street address or plus code that you want to geocode. Provide for geocoding (address to coordinates).
boundsstringThe 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,...
componentsstringA components filter with elements separated by a pipe (|). E.g., 'postal_code:94043|country:US'. Used for geocoding, can be restrictive or biasing.
extra_computationsarrayUse this parameter to specify additional features in the response. Can select multiple values.
keystringYour application's API key. If not provided, will be extracted from connection metadata.
languagestringThe 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...
latlngstringThe 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_typestringA 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_idstringThe place ID of the place for which you wish to obtain the human-readable address. Provide for place ID geocoding.
regionstringThe 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_typestringA 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
avoidstringSpecifies 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'.
destinationstringThe 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.,...
languagestringThe language code for returning results, e.g., 'en' for English, 'es' for Spanish. Defaults to 'en'.default: en
modestringThe mode of transportation for which to calculate directions. Supported values are 'driving' (default), 'walking', 'bicycling', and 'transit'.default: driving
originstringThe 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...
unitsstringThe unit system for displaying distances. Supported values are 'metric' (kilometers and meters) and 'imperial' (miles and feet). Defaults to 'imperial'.default: imperial
waypointsstringA 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
computeAlternativeRoutesbooleanComputes and returns alternative routes if true.default: false
destination_addressstringDestination point address or place name for the route calculation.
fieldMaskstringComma-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
languageCodestringBCP-47 language code (e.g., 'en-US', 'es') for textual information like navigation instructions.default: en-US
origin_addressstringStarting point address or place name for the route calculation.
routeModifiers_avoidFerriesbooleanAttempts to avoid ferries if true.default: false
routeModifiers_avoidHighwaysbooleanAttempts to avoid highways if true.default: false
routeModifiers_avoidTollsbooleanAttempts to avoid toll roads if true.default: false
routingPreferencestringSpecifies 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_OPTIMALtravelModestringMode of transportation for the route.one of
DRIVE · BICYCLE · WALK · TWO_WHEELER · TRANSITdefault: DRIVEunitsstringUnit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances.one of
METRIC · IMPERIALdefault: IMPERIALGOOGLE_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_paramsobjectParameters for 'directions' mode.
modestringThe mode of the embedded map.one of
place · view · directions · streetview · searchplace_paramsobjectParameters for 'place' mode.
search_paramsobjectParameters for 'search' mode.
streetview_paramsobjectParameters for 'streetview' mode.
view_paramsobjectParameters 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
excludedTypesarrayPlace types to exclude (e.g., 'cafe', 'store'); results matching any of these types are omitted. For supported types, see Google Maps Places API documentation.
fieldMaskstringComma-separated list of place fields for the response (e.g., 'places.displayName,places.formattedAddress'); use '*' for all fields.default: places.displayName
includedTypesarrayPlace 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.
latitudenumberLatitude coordinate of the search center in decimal degrees.
longitudenumberLongitude coordinate of the search center in decimal degrees.
maxResultCountintegerMaximum number of search results to return (up to 20); the actual count may be lower.default: 10
radiusnumberRadius 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
fieldMaskstringComma-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
maxResultCountintegerMaximum number of place results to return (must be 1-20). Note: Google prefers `pageSize`, but this action uses `maxResultCount`.default: 10
textQuerystringText query for searching places. Matched against place name, address, and category.
mcp-google_maps
Google Maps MCP Pack — geocoding, places, directions, distance matrix, elevation.
Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ live data sources.
Tools
| Tool | Description |
|---|---|
maps_geocode | "Geocode [address] via Google Maps" / "Google Maps coordinates of [place]" / "lat lng for [address] using Google" — convert an address to lat/lng + formatted address via Google Maps Platform. Premium-quality geocoding (highest accuracy for US addresses); requires Google Maps API key. Use when Mapbox/MapTiler/OpenStreetMap miss the address. |
maps_reverse_geocode | "Reverse geocode [lat,lng] via Google Maps" / "what address is at [coords] in Google" — coordinates → address via Google Maps Platform. Requires Google Maps API key. Use when you need Google's street-address parsing (most accurate for US). |
maps_place_search | "Find restaurants / hotels / coffee shops / [businesses] near [location]" / "nearby [type] within [radius]" / "places to eat in [area]" — find nearby businesses and points of interest via Google Maps Places. Returns names, addresses, Google ratings, distances. Premium-quality POI data; requires Google Maps API key. Use over Yelp/OSM when you want Google's POI coverage and ratings. |
maps_place_details | "Hours / phone / reviews of [business]" / "Google business info for [place]" / "is [restaurant] open" — full details for a Google Place: address, phone, hours, website, ratings, user reviews. Requires a place ID from maps_place_search. Use after search to drill into one specific business. |
maps_directions | "Google Maps directions from A to B" / "transit / public-transport directions" / "bus / subway / train route" / "best way to get from [X] to [Y]" — turn-by-turn directions via Google Maps. Modes: driving, walking, transit (bus/subway/train), bicycling. Requires Google Maps API key. PREFER over Mapbox/OpenRouteService specifically for public-transit routing — Google has the best transit data. |
maps_distance_matrix | "Travel time matrix between [N] origins and [M] destinations" / "drive-time grid via Google Maps" / "transit times between addresses" — N×M distance and duration matrix between many points via Google Maps. Modes: driving, walking, bicycling, transit. Use for delivery routing, multi-stop optimization, transit-heavy planning. |
maps_elevation | "Elevation at [coords] via Google" / "altitude / height above sea level" — elevation in meters for one or more lat/lng pairs via Google Maps Elevation API. Pipe-separated locations for batch queries. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"google_maps": {
"url": "https://gateway.pipeworx.io/google_maps/mcp"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/google_maps/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1476+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Google_maps data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →