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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
unitsstringUnit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances.one of
METRIC · IMPERIALdefault: IMPERIALoriginsarrayList of origin 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
travelModestringMode of transportation for the route matrix calculation.one of
DRIVE · BICYCLE · WALK · TWO_WHEELER · TRANSITdefault: DRIVEdestinationsarrayList of destination locations. Each can be specified as an address or latitude/longitude coordinates.
languageCodestringBCP-47 language code (e.g., 'en-US', 'es') for textual information.default: en-US
routingPreferencestringSpecifies routing preference: `TRAFFIC_UNAWARE` (fastest, ignores traffic), `TRAFFIC_AWARE` (considers traffic, optimized), `TRAFFIC_AWARE_OPTIMAL` (most accurate traffic-based routing), or `ROUTING_PREFERENCE_UNSPECIFIED` (behavior similar to `TRAFFIC_UNAWARE`).one of
ROUTING_PREFERENCE_UNSPECIFIED · TRAFFIC_UNAWARE · TRAFFIC_AWARE · TRAFFIC_AWARE_OPTIMALdefault: TRAFFIC_AWAREGOOGLE_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
keystringYour application's API key. This key identifies your application for purposes of quota management.
modestringSpecifies the mode of transport to use.one of
driving · walking · bicycling · transitdefault: drivingavoidstringIndicates that the calculated route should avoid the specified features. Multiple values can be pipe-separated e.g. 'tolls|highways'.one of
tolls · highways · ferries · indoorunitsstringSpecifies the unit system to use when displaying results. The default is metric.one of
metric · imperialregionstringThe region code, specified as a ccTLD ('top-level domain') two-character value. This helps influence results based on the region.
originsstringThe 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 address, latitude/longitude coordinates (e.g., '40.7128,-74.0060'), a plus code, or an encoded polyline (prefixed with enc: and a colon).
languagestringThe language in which to return results. See the list of supported languages: https://developers.google.com/maps/faq#languagesupport
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.
destinationsstringOne or more locations to use as the finishing point for calculating travel distance and time. Accepts the same formats as origins.
transit_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 · railtraffic_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 · optimisticdeparture_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.
transit_routing_preferencestringSpecifies preferences for transit routes. This parameter may only be specified for transit directions.one of
less_walking · fewer_transfersGOOGLE_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
keystringYour application's API key. If not provided, will be extracted from connection metadata.
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, results.
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.
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.
addressstringThe street address or plus code that you want to geocode. Provide for geocoding (address to coordinates).
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 domain from which the request is sent.
place_idstringThe place ID of the place for which you wish to obtain the human-readable address. Provide for place ID geocoding.
componentsstringA components filter with elements separated by a pipe (|). E.g., 'postal_code:94043|country:US'. Used for geocoding, can be restrictive or biasing.
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.
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.
extra_computationsarrayUse this parameter to specify additional features in the response. Can select multiple values.
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
modestringThe mode of transportation for which to calculate directions. Supported values are 'driving' (default), 'walking', 'bicycling', and 'transit'.default: driving
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'.
unitsstringThe unit system for displaying distances. Supported values are 'metric' (kilometers and meters) and 'imperial' (miles and feet). Defaults to 'imperial'.default: imperial
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,-118.2437').
languagestringThe language code for returning results, e.g., 'en' for English, 'es' for Spanish. Defaults to 'en'.default: en
waypointsstringA comma-separated string of intermediate locations (addresses, place names, or coordinates) to visit between the origin and destination.
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., '40.7128,-74.0060').
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
unitsstringUnit system (e.g., 'METRIC' for kilometers, 'IMPERIAL' for miles) for displaying distances.one of
METRIC · IMPERIALdefault: IMPERIALfieldMaskstringComma-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
travelModestringMode of transportation for the route.one of
DRIVE · BICYCLE · WALK · TWO_WHEELER · TRANSITdefault: DRIVElanguageCodestringBCP-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.
routingPreferencestringSpecifies routing preference: `TRAFFIC_UNAWARE` (fastest, ignores traffic), `TRAFFIC_AWARE` (considers traffic, optimized), `TRAFFIC_AWARE_OPTIMAL` (most accurate traffic-based routing), or `ROUTING_PREFERENCE_UNSPECIFIED` (behavior similar to `TRAFFIC_UNAWARE`). Cannot be set when travelMode is WALK, BICYCLE, or TRANSIT - must be omitted for these modes.one of
ROUTING_PREFERENCE_UNSPECIFIED · TRAFFIC_UNAWARE · TRAFFIC_AWARE · TRAFFIC_AWARE_OPTIMALdestination_addressstringDestination point address or place name for the route calculation.
computeAlternativeRoutesbooleanComputes and returns alternative routes if true.default: false
routeModifiers_avoidTollsbooleanAttempts to avoid toll roads if true.default: false
routeModifiers_avoidFerriesbooleanAttempts to avoid ferries if true.default: false
routeModifiers_avoidHighwaysbooleanAttempts to avoid highways if true.default: false
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
modestringThe mode of the embedded map.one of
place · view · directions · streetview · searchview_paramsobjectParameters for 'view' mode.
place_paramsobjectParameters for 'place' mode.
search_paramsobjectParameters for 'search' mode.
directions_paramsobjectParameters for 'directions' mode.
streetview_paramsobjectParameters for 'streetview' 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
radiusnumberRadius of the circular search area in meters.
latitudenumberLatitude coordinate of the search center in decimal degrees.
fieldMaskstringComma-separated list of place fields for the response (e.g., 'places.displayName,places.formattedAddress'); use '*' for all fields.default: places.displayName
longitudenumberLongitude coordinate of the search center in decimal degrees.
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.
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.
maxResultCountintegerMaximum number of search results to return (up to 20); the actual count may be lower.default: 10
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
textQuerystringText query for searching places. Matched against place name, address, and category.
maxResultCountintegerMaximum number of place results to return (must be 1-20). Note: Google prefers `pageSize`, but this action uses `maxResultCount`.default: 10
mcp-google_maps
Google Maps MCP Pack — geocoding, places, directions, distance matrix, elevation.
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|---|
maps_geocode | Convert an address to coordinates. Returns latitude, longitude, and formatted address. Use when you need to locate a place on a map. |
maps_reverse_geocode | Convert coordinates to a street address. Returns formatted address, city, state, and country. Use to identify what's at a specific location. |
maps_place_search | Find nearby places by type (e.g., restaurants, hotels, parks). Returns names, addresses, ratings, and distances within a radius (in meters). |
maps_place_details | Get full details for a place: address, phone, hours, website, and user reviews. Use with a place ID from search results. |
maps_directions | Get turn-by-turn directions between locations. Returns route, distance, duration, and waypoints. Specify mode: driving, walking, transit, or biking. |
maps_distance_matrix | Calculate travel distance and time between multiple location pairs. Returns matrix with distances and durations for specified mode: driving, walking, transit, or biking. |
maps_elevation | Get elevation in meters for coordinates. Returns elevation and location data. Use to check altitude or terrain height. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"google_maps": {
"url": "https://gateway.pipeworx.io/google_maps/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Google_maps data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
