📌Overview

Purpose: The Google Maps MCP Server provides tools for integrating and utilizing the Google Maps API for various mapping functionalities.

Overview: This framework enables developers to access a wide range of Google Maps features, such as geocoding, place searching, and directions, through straightforward API interactions, enhancing location-based services in applications.

Key Features:

• Geocoding and Reverse Geocoding: Convert addresses to geographic coordinates and vice versa, allowing applications to interpret user locations efficiently.

• Place Search and Details: Search for places using text queries and fetch detailed information about specific locations, helping users discover nearby services and relevant information.

• Distance Matrix Calculation: Determine distances and travel times between multiple origins and destinations, useful for route planning and logistics.

• Elevation Data Access: Retrieve elevation data for specified locations to incorporate topographical information into applications.

• Directions Service: Provide step-by-step navigation between given points, accommodating various travel modes like driving, walking, and transit.

---

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:
https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys

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. You are free to use, modify, and distribute the software under the terms of the MIT License. See the LICENSE file in the project repository for details.