Google Maps

Provides geocoding, places, directions, maps, and environmental data tools via a single MCP endpoint.

typescript

9

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 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": {
    "garblesnarff-google-maps-mcp": {
      "command": "node",
      "args": [
        "/path/to/google-maps-mcp-server/dist/index.js"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

This MCP server provides a focused suite of Google Maps tools for location services, visual mapping, and environmental data, enabling you to query geocoding, search places, retrieve directions, render maps, and fetch weather and related environmental information all through a single, extensible MCP endpoint.

How to use

You run the MCP server locally or in your infrastructure and connect to it using an MCP client. Once connected, you can call tools like geocoding to convert addresses to coordinates, search for places nearby, request turn-by-turn directions, fetch weather forecasts, and render static or street view maps. Use the same central server to combine data from multiple tools for workflows such as trip planning, field research, or location-based analytics.

How to install

Prerequisites: Node.js v18 or newer, an active Google Cloud Platform account with billing enabled, and a Google Maps API key with the required APIs enabled.

Step 1: Install dependencies

git clone https://github.com/garblesnarff/google-maps-mcp
cd google-maps-mcp
npm install

Step 2: Build the server (if applicable) and prepare run command

npm run build

Step 3: Run or configure the MCP server for your environment

npm start

Additional sections

Configuration you will use to connect a client to the server is defined in a runtime configuration that points to the MCP entry point and provides your API key. For local development, you can start the server and supply the API key via environment variables as shown in the example below.

Security and maintenance

Keep your API key secure by using environment variables, restricting the API key to only the APIs you need, and rotating keys periodically. Monitor API usage and set up billing alerts to catch unexpected activity.

Troubleshooting

If you encounter issues, verify that the required Google Maps APIs are enabled for your API key and that the key is correctly supplied to the server via environment variables. Check quota limits and review error messages returned by individual tools.

Available tools

maps_geocode

Convert a physical address into geographic coordinates (latitude and longitude).

maps_reverse_geocode

Find a human-readable address from geographic coordinates.

maps_search_places

Search for businesses, landmarks, and points of interest near a location.

maps_place_details

Retrieve detailed information about a specific place, such as hours and contact details.

maps_directions

Provide turn-by-turn directions between two or more locations with multiple travel modes.

maps_distance_matrix

Calculate travel times and distances between multiple points in a single request.

maps_routes

Compute an enhanced route that can consider traffic, tolls, and other routing factors.

maps_elevation

Get elevation data for terrain analysis along a path or at specific points.

maps_street_view

Fetch panoramic street-level imagery with configurable viewing angles.

maps_static_map

Generate static map images in various styles with optional markers.

maps_weather

Retrieve current conditions and forecasts for specified locations.

maps_air_quality

Access air quality indices and pollutant data for outdoor planning.

maps_solar

Provide solar irradiance data for solar power planning.

maps_pollen

Deliver pollen and allergy information for outdoor activities.