Google Maps MCP Server

MCP Server for the Google Maps API

Tools

maps_geocode

Convert address to coordinates

• Input: address (string)
• Returns: location, formatted_address, place_id

maps_reverse_geocode

Convert coordinates to address

• Inputs:
  • latitude (number)
  • longitude (number)
• Returns: formatted_address, place_id, address_components

maps_search_places

Search for places using text query

• Inputs:
  • query (string)
  • location (optional): { latitude: number, longitude: number }
  • radius (optional): number (meters, max 50000)
• Returns: array of places with names, addresses, locations

maps_place_details

Get detailed information about a place

• Input: place_id (string)
• Returns: name, address, contact info, ratings, reviews, opening hours

maps_distance_matrix

Calculate distances and times between points

• Inputs:
  • origins (string[])
  • destinations (string[])
  • mode (optional): "driving" | "walking" | "bicycling" | "transit"
• Returns: distances and durations matrix

maps_elevation

Get elevation data for locations

• Input: locations (array of {latitude, longitude})
• Returns: elevation data for each point

maps_directions

Get directions between points

• Inputs:
  • origin (string)
  • destination (string)
  • mode (optional): "driving" | "walking" | "bicycling" | "transit"
• Returns: route details with steps, distance, duration

Setup

API Key

Get a Google Maps API key by following the instructions here.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "google-maps": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_MAPS_API_KEY",
        "mcp/google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Build

Docker build:

docker build -t mcp/google-maps -f src/google-maps/Dockerfile .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.