MCP Google Maps Server

You can access Google Maps services (Places, Geocoding, Directions, Distance Matrix, Elevation) through an MCP server that communicates directly via STDIO or via HTTP for development and testing. This server provides fast, robust MCP endpoints you can integrate with any MCP client.

How to use

Choose your preferred connection method. For embedded MCP clients or desktop clients, run the STDIO server and connect via stdin/stdout. For development or testing with HTTP, start the HTTP server and send JSON-RPC requests over HTTP to the provided endpoint.

How to install

Prerequisites: Install Node.js version 18.0.0 or newer.

Option 1 – Global installation (recommended)

npm install -g @vicente-alvarado/mcp-google-map-stdio

Option 2 – Install from source and install globally

git clone https://github.com/vicente-alvarado/mcp-google-map-stdio.git
cd mcp-google-map-stdio
npm install
npm run build
npm install -g .

Verify installation

mcp-google-map-stdio --version

Additional notes

Obtain a Google Maps API key and set it in the environment when you run the servers. For HTTP mode, you will provide the API key in requests or via environment variables depending on your workflow.

Security and usage notes

In HTTP mode, start the server with your API key and an appropriate port, then send requests to the HTTP endpoint. In STDIO mode, provide the Google Maps API key via the GOOGLE_MAPS_API_KEY environment variable when launching the server.

Available tools

search_nearby

Search nearby places by center, radius, and optional filters such as keyword, minRating, and openNow.

get_place_details

Fetch detailed information for a specific place using its placeId.

maps_geocode

Geocode an address to geographic coordinates.

maps_reverse_geocode

Reverse geocode coordinates to a readable address.

maps_distance_matrix

Compute distances and travel times between origins and destinations across modes.

maps_directions

Get detailed directions between two points with optional departure or arrival times.

maps_elevation

Retrieve elevation data for a list of locations.