# Google Maps MCP

> Google Maps MCP is an open-source MCP server for maps and travel. Geocoding, places, directions, distances, elevation and time zones from Google Maps. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** vscode, CLI, macOS, Windows, Linux
- **Website:** https://renzojohnson.com/contributions/google-maps-mcp
- **MCP Registry name:** com.renzojohnson/google-maps-mcp
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

Eight tools wrap Google Maps Platform and return data only: it does not draw maps or produce map images. Place details return a handful of recent reviews, not the full history, because that is what Google's API gives back.

The server runs on your machine with your own API key, which needs a Google Cloud project with billing on and the relevant APIs enabled and restricted. Google bills calls beyond its free monthly allowance to that project. The author states it is an independent project, not an official Google server, with no telemetry; in VS Code the key sits in encrypted secret storage.

It ships as a VS Code extension that registers itself with Copilot, Claude Code, Cursor, Codex, Gemini, Windsurf, Continue.dev and Cline, and as an npm package (Node 22 or newer) for any other client. Outside VS Code it takes Google credentials from OAuth variables, a key file or gcloud defaults. MIT licensed.

## Features

- **Address geocoding:** Converts addresses to coordinates, formatted addresses and place IDs, and back.
- **Place search and details:** Finds places by text and reads hours, phone, website and recent reviews.
- **Routes and distances:** Directions with steps, plus a matrix of travel times between many points.
- **Elevation lookup:** Returns elevation in meters for up to 100 points.
- **Time zone lookup:** Gives the time zone and current UTC offset for a location.
- **Auto-registration:** The VS Code extension writes config for each detected agent.

## Good for

- Clean an address list with coordinates
- Check a store locator against real nearest-location answers
- Pick the closest depot for each customer by drive time
- Look up opening hours for a place
- Find the time zone of a site

## Install

### Claude Code (Terminal)

```sh
claude mcp add google-maps-mcp --env GOOGLE_MAPS_API_KEY='<GOOGLE_MAPS_API_KEY>' -- npx -y @renzo.johnson/google-maps-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "google-maps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-maps-mcp"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "google-maps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-maps-mcp"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "google-maps-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-maps-mcp"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "google-maps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-maps-mcp"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "google-maps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-maps-mcp"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
```

## Tools

- `maps_geocode`: Turns an address into coordinates, formatted address and place ID.
- `maps_reverse_geocode`: Turns coordinates into nearby addresses.
- `maps_search_places`: Searches places by text near a point.
- `maps_place_details`: Returns phone, website, hours, rating and recent reviews.
- `maps_directions`: Returns a route with distance, duration and steps.
- `maps_distance_matrix`: Returns travel distance and time between origins and destinations.
- `maps_elevation`: Returns elevation for up to 100 points.
- `maps_timezone`: Returns time zone and UTC offset for a location.

## FAQ

### Is it free?

The extension is free and MIT licensed; Google charges for API use beyond its free allowance.

### Why an API key?

Google Maps Platform identifies callers by key.

### Is it official?

No, it is an independent project.

### Which Node version?

Node.js 22 or newer for the npm package.

### Is Google Maps MCP free?

Yes. Google Maps MCP is open source, so you can use and self-host it for free.

### How do I add Google Maps MCP to Claude Code?

Run this command in your terminal: claude mcp add google-maps-mcp --env GOOGLE_MAPS_API_KEY='<GOOGLE_MAPS_API_KEY>' -- npx -y @renzo.johnson/google-maps-mcp

### What are the best alternatives to Google Maps MCP?

The closest alternatives to Google Maps MCP are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/google-maps-mcp-2
