# Google Maps MCP server

> Lets an AI client search places, geocode addresses, get directions, plan routes, check weather, and audit local rankings via Google Maps APIs.

- Repository: https://github.com/cablate/mcp-google-map
- Page: https://hostedmcp.org/servers/cablate/mcp-google-map
- Transport: stdio
- Stars: 498
- License: MIT
- Latest version: 0.0.69

## Install

### Claude Code

```sh
claude mcp add --env 'GOOGLE_MAPS_API_KEY=<YOUR_GOOGLE_MAPS_API_KEY>' mcp-google-map -- npx -y @cablate/mcp-google-map
```

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

```json
{
  "mcpServers": {
    "mcp-google-map": {
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-google-map"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-google-map": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-google-map"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp-google-map","type":"stdio","command":"npx","args":["-y","@cablate/mcp-google-map"],"env":{"GOOGLE_MAPS_API_KEY":"<YOUR_GOOGLE_MAPS_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp-google-map": {
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-google-map"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp-google-map --env 'GOOGLE_MAPS_API_KEY=<YOUR_GOOGLE_MAPS_API_KEY>' -- npx -y @cablate/mcp-google-map
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-google-map]
command = "npx"
args = ["-y", "@cablate/mcp-google-map"]

[mcp_servers.mcp-google-map.env]
GOOGLE_MAPS_API_KEY = "<YOUR_GOOGLE_MAPS_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'GOOGLE_MAPS_API_KEY=<YOUR_GOOGLE_MAPS_API_KEY>' mcp-google-map npx -- -y @cablate/mcp-google-map
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-google-map": {
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-google-map"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_GOOGLE_MAPS_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GOOGLE_MAPS_API_KEY` | yes | yes | Google Maps API key (get one at https://console.cloud.google.com) |
| `GOOGLE_MAPS_API_KEY` | no | no |  |
| `GOOGLE_MAPS_ENABLED_TOOLS` | no | no |  |
| `GOOGLE_MAPS_ENABLED_TOOLS` | no | no | Comma-separated tool names to enable. Omit or * for all 18 tools. |

## FAQ

### What can an AI agent do with the Google Maps MCP server?

It can search places, get place details, geocode addresses, calculate directions and distance matrices, plan multi-stop routes, and check weather, air quality, elevation, and timezone. It also supports local search visibility audits.

### How do I authenticate the Google Maps MCP server?

You supply a Google Maps Platform API key, either via the GOOGLE_MAPS_API_KEY environment variable, the --apikey option, or the X-Google-Maps-API-Key HTTP header.

### Do I need MCP to use these Google Maps tools?

No. The same capabilities are available through a standalone CLI with short subcommands such as geocode, search-places, and directions, and through Codex or Claude Code plugins that load Skills without an MCP server.

### Can I limit which Google Maps tools are exposed?

Yes. Set GOOGLE_MAPS_ENABLED_TOOLS to a comma-separated allowlist to expose only the tools you need, or omit it or use * for the full catalog.

### Can the Google Maps server run over HTTP for remote or shared use?

Yes. Running with --host and --port serves MCP over Streamable HTTP at /mcp, and per-session API key isolation is supported via the request header.
