OpenMCP

google-maps

...

@open-mcp/google-maps

Installing

First set the environment variables as shell variables:

KEY='...'

Then use the OpenMCP config CLI to add the server to your MCP client:

Claude desktop

npx @open-mcp/config add google-maps \
  ~/Library/Application\ Support/Claude/claude_desktop_config.json \
  --KEY=$KEY

Cursor

Run this from the root of your project directory or, to add to all cursor projects, run it from your home directory ~.

npx @open-mcp/config add google-maps \
  .cursor/mcp.json \
  --KEY=$KEY

Other

npx @open-mcp/config add google-maps \
  /path/to/client/config.json \
  --KEY=$KEY

Manually

If you don't want to use the helper above, add the following to your MCP client config manually:

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": ["-y", "@open-mcp/google-maps"],
      "env": {"KEY":"..."}
    }
  }
}

Customizing the base URL

Set the environment variable OPEN_MCP_BASE_URL to override each tool's base URL. This is useful if your OpenAPI spec defines a relative server URL.

Other environment variables

  • KEY

Inspector

Needs access to port 3000 for running a proxy server, will fail if http://localhost:3000 is already busy.

npx -y @modelcontextprotocol/inspector npx -y @open-mcp/google-maps
  • Open http://localhost:5173
  • Transport type: STDIO
  • Command: npx
  • Arguments: -y @open-mcp/google-maps
  • Click Environment Variables to add
  • Click Connect

It should say MCP Server running on stdio in red.

  • Click List Tools

Tools

expandSchema

Expand the input schema for a tool before calling the tool

Input schema

  • toolName (string)
  • jsonPointers (array)

geolocate

Environment variables

  • KEY

Input schema

  • homeMobileCountryCode (integer)
  • homeMobileNetworkCode (integer)
  • radioType (string)
  • carrier (string)
  • considerIp (string)
  • cellTowers (array)
  • wifiAccessPoints (array)

directions

Environment variables

  • KEY

Input schema

  • arrival_time (number)
  • departure_time (number)
  • alternatives (boolean)
  • avoid (string)
  • destination (string)
  • origin (string)
  • units (string)
  • waypoints (string)
  • language (string)
  • mode (string)
  • region (string)
  • traffic_model (string)
  • transit_mode (string)
  • transit_routing_preference (string)

elevation

Environment variables

  • KEY

Input schema

  • locations (array)
  • path (array)
  • samples (number)

geocode

Environment variables

  • KEY

Input schema

  • address (string)
  • bounds (array)
  • components (array)
  • latlng (string)
  • location_type (array)
  • place_id (string)
  • result_type (array)
  • language (string)
  • region (string)

timezone

Environment variables

  • KEY

Input schema

  • language (string)
  • location (string)
  • timestamp (number)

snaptoroads

Environment variables

  • KEY

Input schema

  • path (array)
  • interpolate (boolean)

nearestroads

Environment variables

  • KEY

Input schema

  • points (array)

distancematrix

Environment variables

  • KEY

Input schema

  • arrival_time (number)
  • departure_time (number)
  • avoid (string)
  • destinations (array)
  • origins (array)
  • units (string)
  • language (string)
  • mode (string)
  • region (string)
  • traffic_model (string)
  • transit_mode (string)
  • transit_routing_preference (string)

placedetails

Environment variables

  • KEY

Input schema

  • place_id (string)
  • fields (array)
  • sessiontoken (string)
  • language (string)
  • region (string)
  • reviews_sort (string)
  • reviews_no_translations (boolean)

findplacefromtext

Environment variables

  • KEY

Input schema

  • fields (array)
  • input (string)
  • inputtype (string)
  • locationbias (string)
  • language (string)

nearbysearch

Environment variables

  • KEY

Input schema

  • keyword (string)
  • location (string)
  • maxprice (string)
  • minprice (string)
  • name (string)
  • opennow (boolean)
  • pagetoken (string)
  • rankby (string)
  • radius (number)
  • type (string)
  • language (string)

textsearch

Environment variables

  • KEY

Input schema

  • location (string)
  • maxprice (string)
  • minprice (string)
  • opennow (boolean)
  • pagetoken (string)
  • query (string)
  • radius (number)
  • type (string)
  • language (string)
  • region (string)

placephoto

Environment variables

  • KEY

Input schema

  • photo_reference (string)
  • maxheight (number)
  • maxwidth (number)

queryautocomplete

Environment variables

  • KEY

Input schema

  • input (string)
  • offset (number)
  • location (string)
  • radius (number)
  • language (string)

autocomplete

Environment variables

  • KEY

Input schema

  • input (string)
  • sessiontoken (string)
  • components (string)
  • strictbounds (boolean)
  • offset (number)
  • origin (string)
  • location (string)
  • locationbias (string)
  • locationrestriction (string)
  • radius (number)
  • types (string)
  • language (string)
  • region (string)

streetview

Environment variables

  • KEY

Input schema

  • fov (number)
  • heading (number)
  • location (string)
  • pano (string)
  • pitch (number)
  • radius (number)
  • return_error_code (boolean)
  • signature (string)
  • size (string)
  • source (string)

streetviewmetadata

Environment variables

  • KEY

Input schema

  • heading (number)
  • location (string)
  • pano (string)
  • pitch (number)
  • radius (number)
  • return_error_code (boolean)
  • signature (string)
  • size (string)
  • source (string)