Google Maps MCP
Geocoding, places, directions, distances, elevation and time zones from Google Maps
- 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-mcpAdd 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

Tutu eSIM
MCP serverLive travel eSIM plans, prices and roaming costs for 190+ countries
- 5 tools
- Remote
- Paid
- Maps and travel

Shanghai Streets Travel Guide
MCP serverCurated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang
- 9 tools
- Remote
- Free
- Maps and travel
Fifty Asks
MCP serverLet an agent book a free AI-visibility check or a 15-minute call for a local business
- 10 tools
- Remote
- Free
- Maps and travel

Gangway AIS
MCP serverVessel positions, port calls and anchorage waiting times from licensed AIS data
- 21 tools
- Remote
- Freemium
- Freight and logistics
Public tour and ticket search for Gramado, Calafate, Bariloche, Ushuaia and Cartagena
- 3 tools
- Remote
- Free
- Maps and travel

Goyondo
MCP serverAgent-native trip planner where your AI builds the itinerary and Goyondo stores it
- Remote
- Freemium
- Maps and travel