Google Maps Geocoding

Provides access to Google Maps Geocoding features including forward, reverse, and place geocoding with language options.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kevinwuhoo-google-maps-geocoding-mcp": {
      "command": "npx",
      "args": [
        "google-maps-geocoding-mcp"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can use this MCP Server to access Google Maps Geocoding capabilities from any MCP-compatible client. It supports forward geocoding, reverse geocoding, and place ID lookups, with options for language preferences and filtering to tailor results to your needs.

How to use

To use this server with an MCP client, run the local MCP server and point your client at the provided command. You communicate your geocoding requests through the MCP interface, and the server returns structured geocoding results such as coordinates, addresses, and place details. Use it to convert addresses to coordinates, find addresses from coordinates, or resolve Google Place IDs to human-friendly addresses. You can also request results in a specific language and apply filters to narrow results by type and components.

How to install

Prerequisites you need to prepare before installation.

Obtain a Google Maps API key from the Google Cloud Console.
Install Node.js version 18 or higher from the official Node.js website.
Install an MCP-compatible client such as Claude Desktop or Cursor.

Additional sections

Configuration and startup are designed to be straightforward. You provide the Google Maps API key to the MCP server at runtime via environment variables, and you run the server using a standard node-based startup flow. Here are concrete steps to get running with the standard setup shown in examples.

Security and notes

Keep your Google Maps API key secure. Do not expose it in client-side code or public repositories. Use restricted API keys and apply appropriate usage restrictions in the Google Cloud Console to minimize exposure. If you need to rotate keys, update the environment variable and restart the MCP server.

Troubleshooting

If the MCP server fails to connect, ensure you are using Node.js 18 or newer and verify your MCP client configuration. For API key issues, confirm the key is correct, the Geocoding API is enabled, and key restrictions permit usage from your environment.

Usage patterns

Forward Geocoding: ask for coordinates corresponding to an address. Reverse Geocoding: ask for an address corresponding to coordinates. Place Geocoding: ask for an address from a Google Place ID. You can combine language preferences and advanced filtering to refine results.

Available tools

forwardGeocoding

Converts a user-supplied address into geographic coordinates (latitude and longitude).

reverseGeocoding

Converts geographic coordinates into a human-readable address.

placeGeocoding

Resolves a Google Place ID to a human-friendly address.

languageSupport

Returns geocoding results in a specified language when available.

advancedFiltering

Applies filters by result types, location types, and components to narrow results.