Skip to content
MCP server

Google Maps MCP

Geocoding, places, directions, distances, elevation and time zones from Google Maps

Runs locallyStatus and history
Pricing
Open source
Platforms
vscode, CLI, macOS
Runs
Locally
Version
26.11.14
Listing updated
3 days ago

About Google Maps MCP

Google Maps MCP is an open-source MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • GOOGLE_MAPS_API_KEYGoogle Maps Platform API key with the Maps APIs you use enabled.Required

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free, MIT licensed; Google Maps Platform usage billed separately

Prices change. Check renzojohnson.com before you buy.

Google Maps MCP 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 to Google Maps MCP

  1. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  2. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel
  3. Fifty Asks

    MCP server

    Let an agent book a free AI-visibility check or a 15-minute call for a local business

    • 10 tools
    • Remote
    • Free
    • Maps and travel
  4. Gangway AIS

    MCP server

    Vessel positions, port calls and anchorage waiting times from licensed AIS data

    • 21 tools
    • Remote
    • Freemium
    • Freight and logistics
  5. Goyondo

    MCP server

    Agent-native trip planner where your AI builds the itinerary and Goyondo stores it

    • Remote
    • Freemium
    • Maps and travel