📌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 a 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

To build the Docker image, run:

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

License

This MCP server is licensed under the MIT License, allowing you to use, modify, and distribute the software under its terms. For more details, please see the LICENSE file in the project repository.