Google Maps Geocoding MCP Server
Provides access to Google Maps Geocoding API, enabling forward geocoding (address to coordinates), reverse geocoding (coordinates to address), and Place ID lookups with support for multi-language results and advanced filtering.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Google Maps Geocoding MCP Server what's the address at coordinates 40.7128, -74.0060?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Google Maps Geocoding MCP Server
A Model Context Protocol (MCP) server that provides access to Google Maps Geocoding API. This server enables LLM clients like Claude Desktop and Cursor to perform address geocoding, reverse geocoding, and place ID lookups. The aim of this MCP is only the Geocoding API. This is because there isn't great support for connecting to many MCP servers yet in most tools.
Features
🗺️ Forward Geocoding: Convert addresses to coordinates
📍 Reverse Geocoding: Convert coordinates to addresses
🏢 Place Geocoding: Convert Google Place IDs to addresses
🌍 Multi-language Support: Get results in different languages
🎯 Advanced Filtering: Filter by result types, location types, and components
🚀 Built on Official SDK: Uses Google's official
@googlemaps/google-maps-services-jslibrary will full TypeScript support
Related MCP server: Local Business Data MCP Server
Prerequisites
Google Maps API Key: Get one from the Google Cloud Console
Node.js: Version 18 or higher
Claude Desktop or Cursor (or another MCP-compatible client)
Setup with MCP Clients
Claude Desktop
Edit your Claude Desktop config file:
Platform | Config File Location |
macOS |
|
Windows |
|
{
"mcpServers": {
"google-maps-geocoding": {
"command": "npx",
"args": ["google-maps-geocoding-mcp"],
"env": {
"GOOGLE_MAPS_API_KEY": "your_api_key_here"
}
}
}
}Then restart Claude Desktop and ask Claude to geocode an address!
Cursor
Add to your Cursor settings (Settings → Extensions → MCP Servers):
{
"mcp.servers": [
{
"name": "google-maps-geocoding",
"command": "npx",
"args": ["google-maps-geocoding-mcp"],
"env": {
"GOOGLE_MAPS_API_KEY": "your_api_key_here"
}
}
]
}Test the integration using the AI chat!
Usage Examples
Forward Geocoding (Address → Coordinates)
Ask your AI client:
"Geocode the address '1600 Amphitheatre Parkway, Mountain View, CA'"
Reverse Geocoding (Coordinates → Address)
Ask your AI client:
"What address is at coordinates 37.4224764, -122.0842499?"
Place Geocoding (Place ID → Address)
Ask your AI client:
"Get the address for Google Place ID 'ChIJd8BlQ2BZwokRAFUEcm_qrcA'"
Advanced Usage
With component filtering:
"Find 'Main Street' in San Francisco, CA, US"
With language preferences:
"Geocode 'Champs-Élysées' in French"
With regional biasing:
"Find restaurants near coordinates 37.7749, -122.4194 in the US region"
Common Issues
MCP Server not connecting:
Verify Node.js version is 18+
Check your MCP client configuration
API key errors:
Verify your API key is correct
Check that the Geocoding API is enabled in Google Cloud Console
Ensure API key restrictions allow your usage
Debug Mode
Enable debug logging by setting:
LOG_LEVEL=debug npx google-maps-geocoding-mcpContributing
Contributions are welcome! Please see CONTRIBUTING.md for development setup, guidelines, and how to submit changes.
Available Tools
3 toolsgeocode_forwardB
Convert an address to geographic coordinates (latitude/longitude) using Google Maps Geocoding API.
Inputs: address (required), components, bounds, language, +3 more.
geocode_placeC
Convert a Google Place ID to a human-readable address using Google Maps Geocoding API.
Inputs: place_id (required), language, region, result_type, +1 more.
geocode_reverseB
Convert geographic coordinates (latitude/longitude) to a human-readable address using Google Maps Geocoding API.
Inputs: latlng (required), language, region, result_type, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: geocode_forward handles addresses to coordinates, geocode_place converts Place IDs to addresses, and geocode_reverse does coordinates to addresses. There is no overlap or ambiguity between these three operations.
All tool names follow a consistent 'geocode_' prefix with descriptive suffixes (forward, place, reverse), using snake_case uniformly. This pattern is predictable and enhances readability.
With 3 tools, the server is well-scoped for geocoding operations, covering the essential forward, reverse, and Place ID conversions. Each tool earns its place without being excessive or insufficient for the domain.
The tool set provides complete coverage for the Google Maps Geocoding domain, including forward geocoding, reverse geocoding, and Place ID resolution. There are no obvious gaps, as these are the core operations offered by the API.
Maintenance
Related MCP Connectors
Routing, geocoding, places, matrix and map tools for location-aware AI workflows.
Geocoding, reverse geocoding, and places search for LatLng.
Location tools for Claude and other MCP clients, strongest in the US and Great Britain. Geocode whole lists with a confidence score per row, filter by distance, get road distances and drive-time areas, and plan multi-driver routes with Google Maps links. Check flood zones, crime and live warnings, find nearby places and UK registers (NHS, CQC, food hygiene), and keep shareable maps. Reads and writes Google Sheets. Free: sign in with Google.
Geocoding, weather forecasts, and timezone lookups
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables LLMs to perform travel-related tasks by interacting with Google Maps and travel planning services including location search, place details, and travel time calculations.598MIT
- AlicenseBqualityNot gradedmaintenanceEnables access to Google Maps business data including search, reviews, photos, and geocoding. Supports searching businesses by location, area, or coordinates, retrieving detailed business information, reviews, and performing reverse geocoding operations.13MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to access Google Maps services including places search, details, directions, geocoding, and nearby search through natural language.628 PyPI3MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Google Maps API for geocoding, place search, directions, distance matrices, and elevation data through natural language.23 PyPIMIT