src_google_maps
by modelcontextprotocolGoogle Maps MCP Server
The Google Maps MCP Server is a powerful integration of the Google Maps API within the Model Context Protocol (MCP) framework. It provides a suite of tools for geocoding, reverse geocoding, place search, distance calculations, and more, enabling seamless location-based functionalities in your applications.
Tools
The server offers the following tools to interact with the Google Maps API:
1. maps_geocode
- Purpose: Convert an address to coordinates.
- Input:
address(string) - Returns:
location,formatted_address,place_id
2. maps_reverse_geocode
- Purpose: Convert coordinates to an address.
- Inputs:
latitude(number)longitude(number)- Returns:
formatted_address,place_id,address_components
3. maps_search_places
- Purpose: 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
- Purpose: Get detailed information about a place.
- Input:
place_id(string) - Returns:
name,address,contact info,ratings,reviews,opening hours
5. maps_distance_matrix
- Purpose: 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
- Purpose: Get elevation data for locations.
- Input:
locations(array of{latitude, longitude}) - Returns: Elevation data for each point
7. maps_directions
- Purpose: 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
To use the Google Maps MCP Server, you need a Google Maps API key. Follow the instructions here to create one.
Usage with Claude Desktop
Docker
Add the following configuration to your claude_desktop_config.json:
{
"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
Alternatively, you can use NPX for setup:
{
"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 the following command:
docker build -t mcp/google-maps -f src/google-maps/Dockerfile .
License
This MCP server is licensed under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, refer to the LICENSE file in the project repository.
Invite Gmail Contacts
