What is Google Map Mcp

google-map-mcp is an MCP Server designed to interface with the Google Maps API, providing various functionalities such as geocoding, place searching, and distance calculations.

Use cases

Use cases include converting addresses to coordinates for mapping applications, finding nearby places for travel apps, calculating travel times for logistics, and providing directions for navigation services.

How to use

To use google-map-mcp, obtain a Google Maps API key and configure it in your application. You can then utilize various tools like maps_geocode, maps_reverse_geocode, and others to access location-based services.

Key features

Key features include geocoding addresses, reverse geocoding coordinates, searching for places, retrieving place details, calculating distances and durations, obtaining elevation data, and providing directions.

Where to use

google-map-mcp can be used in various fields such as transportation, logistics, real estate, tourism, and any application requiring location-based services.

Google Maps MCP Server

MCP Server for the Google Maps API.

Tools

1. maps_geocode

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

2. maps_reverse_geocode

   • Convert coordinates to address
   • Inputs:
     • latitude (number)
     • longitude (number)
   • Returns: formatted_address, place_id, address_components

3. 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

4. maps_place_details

   • Get detailed information about a place
   • Input: place_id (string)
   • Returns: name, address, contact info, ratings, reviews, opening hours

5. 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

6. maps_elevation

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

7. 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.