Google Maps MCP Server
Simplest remote MCP server implementation
what is Google Maps MCP Server?
Google Maps MCP Server is a simple implementation of a remote server that interacts with the Google Maps API, allowing users to access various mapping functionalities.
how to use Google Maps MCP Server?
To use the server, you need to set up a Google Maps API key and configure it in your application. You can run the server using Docker or NPX commands as specified in the setup instructions.
key features of Google Maps MCP Server?
- Geocoding: Convert addresses to coordinates and vice versa.
- Place Search: Search for places using text queries.
- Distance Matrix: Calculate distances and travel times between multiple points.
- Directions: Get detailed directions between locations.
- Elevation Data: Retrieve elevation information for specific coordinates.
use cases of Google Maps MCP Server?
- Building location-based applications that require mapping functionalities.
- Integrating geocoding services into web or mobile apps.
- Providing users with distance and travel time calculations for route planning.
FAQ from Google Maps MCP Server?
- How do I get a Google Maps API key?
You can obtain an API key by following the instructions on the Google Maps documentation site.
- Is there a limit to the number of requests I can make?
Yes, Google Maps API has usage limits based on the type of account you have.
- Can I use this server for commercial purposes?
Yes, as long as you comply with the terms of the Google Maps API usage.
Google Maps MCP Server
MCP Server for the Google Maps API.
Tools
-
maps_geocode- Convert address to coordinates
- Input:
address(string) - Returns: location, formatted_address, place_id
-
maps_reverse_geocode- Convert coordinates to address
- Inputs:
latitude(number)longitude(number)
- Returns: formatted_address, place_id, address_components
-
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
-
maps_place_details- Get detailed information about a place
- Input:
place_id(string) - Returns: name, address, contact info, ratings, reviews, opening hours
-
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
-
maps_elevation- Get elevation data for locations
- Input:
locations(array of {latitude, longitude}) - Returns: elevation data for each point
-
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.
