mcpField
G
Google Maps MCP Server

Google Maps MCP Server

Local
github.com/Moe03Media & Design0Updated 81w ago
Repository

About Google Maps MCP Server

Google Maps MCP Server exposes Google Maps API capabilities to MCP clients. It supports geocoding, place search and details, routes, distance matrices, and elevation lookup.

Key features

  1. 01Convert addresses and coordinates
  2. 02Search places and retrieve details
  3. 03Calculate routes and travel times
  4. 04Look up location elevation

Use cases

  1. 01Turning an address into coordinates
  2. 02Finding nearby places from a text query
  3. 03Comparing travel times between locations
  4. 04Retrieving directions and elevation data

MCP support

It provides Google Maps API tools to MCP clients, including geocoding, place search, directions, distance matrices, and elevation.

#google-maps#mcp-server#api-integration

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hello-world-moe03": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
Run commanddocker run -i --rm build

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocibuild

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.