osm-mcp-server
Provides location-based services and geospatial data from OpenStreetMap, including geocoding, reverse geocoding, nearby point-of-interest search, route directions, category search, meeting point suggestion, area exploration, school/EV charging station/parking facility search, commute analysis, and neighborhood livability analysis.
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., "@osm-mcp-server Find coffee shops near the Eiffel Tower"
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.
OpenStreetMap (OSM) MCP Server
An OpenStreetMap MCP server implementation that enhances LLM capabilities with location-based services and geospatial data.
Demo
Meeting Point Optimization

Neighborhood Analysis

Parking Search

Related MCP server: OpenStreetMap MCP Server
Installation
In MCP Hosts like Claude Desktop, Cursor, Windsurf, etc.
osm-mcp-server: The main server, available for public use."mcpServers": { "osm-mcp-server": { "command": "uvx", "args": [ "osm-mcp-server" ] } }
Features
This server provides LLMs with tools to interact with OpenStreetMap data, enabling location-based applications to:
Geocode addresses and place names to coordinates
Reverse geocode coordinates to addresses
Find nearby points of interest
Get route directions between locations
Search for places by category within a bounding box
Suggest optimal meeting points for multiple people
Explore areas and get comprehensive location information
Find schools and educational institutions near a location
Analyze commute options between home and work
Locate EV charging stations with connector and power filtering
Perform neighborhood livability analysis for real estate
Find parking facilities with availability and fee information
Components
Resources
The server implements location-based resources:
location://place/{query}: Get information about places by name or addresslocation://map/{style}/{z}/{x}/{y}: Get styled map tiles at specified coordinates
Tools
The server implements several geospatial tools:
geocode_address: Convert text to geographic coordinatesreverse_geocode: Convert coordinates to human-readable addressesfind_nearby_places: Discover points of interest near a locationget_route_directions: Get turn-by-turn directions between locationssearch_category: Find places of specific categories in an areasuggest_meeting_point: Find optimal meeting spots for multiple peopleexplore_area: Get comprehensive data about a neighborhoodfind_schools_nearby: Locate educational institutions near a specific locationanalyze_commute: Compare transportation options between home and workfind_ev_charging_stations: Locate EV charging infrastructure with filteringanalyze_neighborhood: Evaluate neighborhood livability for real estatefind_parking_facilities: Locate parking options near a destination
Local Testing
Running the Server
To run the server locally:
Install the package in development mode:
pip install -e .Start the server:
osm-mcp-serverThe server will start and listen for MCP requests on the standard input/output.
Testing with Example Clients
The repository includes two example clients in the examples/ directory:
Basic Client Example
client.py demonstrates basic usage of the OSM MCP server:
python examples/client.pyThis will:
Connect to the locally running server
Get information about San Francisco
Search for restaurants in the area
Retrieve comprehensive map data with progress tracking
LLM Integration Example
llm_client.py provides a helper class designed for LLM integration:
python examples/llm_client.pyThis example shows how an LLM can use the Location Assistant to:
Get location information from text queries
Find nearby points of interest
Get directions between locations
Find optimal meeting points
Explore neighborhoods
Writing Your Own Client
To create your own client:
Import the MCP client:
from mcp.client import ClientInitialize the client with your server URL:
client = Client("http://localhost:8000")Invoke tools or access resources:
# Example: Geocode an address
results = await client.invoke_tool("geocode_address", {"address": "New York City"})Claude Desktop config for local server
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
"mcpServers": {
"osm-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/osm-mcp-server",
"run",
"osm-mcp-server"
]
}
}Development
Building and Publishing
To prepare the package for distribution:
Sync dependencies and update lockfile:
uv syncBuild package distributions:
uv buildThis will create source and wheel distributions in the dist/ directory.
Publish to PyPI:
uv publishNote: You'll need to set PyPI credentials via environment variables or command flags.
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via npm with this command:
npx @modelcontextprotocol/inspector uv --directory /path/to/osm-mcp-server run osm-mcp-serverUpon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
Available Tools
12 toolsanalyze_commuteA
Perform a detailed commute analysis between home and work locations.
This advanced tool analyzes commute options between two locations (typically home and work), comparing multiple transportation modes and providing detailed metrics for each option. Includes estimated travel times, distances, turn-by-turn directions, and other commute-relevant data. Essential for real estate decisions, lifestyle planning, and workplace relocation analysis.
Args: home_latitude: Home location latitude (decimal degrees) home_longitude: Home location longitude (decimal degrees) work_latitude: Workplace location latitude (decimal degrees) work_longitude: Workplace location longitude (decimal degrees) modes: List of transportation modes to analyze (options: "car", "foot", "bike") depart_at: Optional departure time (format: "HH:MM") for time-sensitive routing
Returns: Comprehensive commute analysis with: - Summary comparing all transportation modes - Detailed route information for each mode - Total distance and duration for each option - Turn-by-turn directions
Inputs: home_latitude (required), work_latitude (required), home_longitude (required), work_longitude (required), +2 more.
analyze_neighborhoodA
Generate a comprehensive neighborhood analysis focused on livability factors.
This advanced analysis tool evaluates a neighborhood based on multiple livability factors, including amenities, transportation options, green spaces, and services. Results include counts and proximity scores for various categories, helping to assess the overall quality and convenience of a residential area. Invaluable for real estate decisions, relocation planning, and neighborhood comparisons.
Args: latitude: Center point latitude (decimal degrees) longitude: Center point longitude (decimal degrees) radius: Analysis radius in meters (defaults to 1000m/1km)
Returns: Comprehensive neighborhood profile including: - Overall neighborhood score - Walkability assessment - Public transportation access - Nearby amenities (shops, restaurants, services) - Green spaces and recreation - Education and healthcare facilities - Detailed counts and distance metrics for each category
Inputs: latitude (required), longitude (required), radius.
explore_areaA
Generate a comprehensive profile of an area including all amenities and features.
This powerful analysis tool creates a detailed overview of a neighborhood or area by identifying and categorizing all geographic features, amenities, and points of interest. Results are organized by category for easy analysis. Excellent for neighborhood research, area comparisons, and location-based decision making.
Args: latitude: Center point latitude (decimal degrees) longitude: Center point longitude (decimal degrees) radius: Search radius in meters (defaults to 500m)
Returns: In-depth area profile including: - Address and location context - Total feature count - Features organized by category and subcategory - Each feature includes name, coordinates, and detailed metadata
Inputs: latitude (required), longitude (required), radius.
find_ev_charging_stationsA
Locate electric vehicle charging stations near a specific location.
This specialized search tool identifies EV charging infrastructure within a specified distance from a location. Results can be filtered by connector type (Tesla, CCS, CHAdeMO, etc.) and minimum power delivery. Essential for EV owners planning trips or evaluating potential charging stops.
Args: latitude: Center point latitude (decimal degrees) longitude: Center point longitude (decimal degrees) radius: Search radius in meters (defaults to 5000m/5km) connector_types: Optional list of specific connector types to filter by (e.g., ["type2", "ccs", "tesla"]) min_power: Minimum charging power in kW
Returns: List of charging stations with: - Location name and operator - Available connector types - Charging speeds - Number of charging points - Access restrictions - Other relevant metadata
Inputs: latitude (required), longitude (required), radius, min_power, +1 more.
find_nearby_placesA
Discover points of interest and amenities near a specific location.
This tool performs a comprehensive search around a geographic point to identify nearby establishments, amenities, and points of interest. Results are organized by category and subcategory, making it easy to find specific types of places. Essential for location-based recommendations, neighborhood analysis, and proximity-based decision making.
Args: latitude: Center point latitude (decimal degrees) longitude: Center point longitude (decimal degrees) radius: Search radius in meters (defaults to 1000m/1km) categories: List of OSM categories to search for (e.g., ["amenity", "shop", "tourism"]). If omitted, searches common categories. limit: Maximum number of total results to return
Returns: Structured dictionary containing: - Original query parameters - Total count of places found - Results grouped by category and subcategory - Each place includes name, coordinates, and associated tags
Inputs: latitude (required), longitude (required), limit, radius, +1 more.
find_parking_facilitiesA
Locate parking facilities near a specific location.
This tool finds parking options (lots, garages, street parking) near a specified location. Results can be filtered by parking type and include capacity information where available. Useful for trip planning, city navigation, and evaluating parking availability in urban areas.
Args: latitude: Center point latitude (decimal degrees) longitude: Center point longitude (decimal degrees) radius: Search radius in meters (defaults to 1000m/1km) parking_type: Optional filter for specific types of parking facilities ("surface", "underground", "multi-storey", etc.)
Returns: List of parking facilities with: - Name and type - Capacity information if available - Fee structure if available - Access restrictions - Distance from search point
Inputs: latitude (required), longitude (required), radius, parking_type.
find_schools_nearbyA
Locate educational institutions near a specific location, filtered by education level.
This specialized search tool identifies schools, colleges, and other educational institutions within a specified distance from a location. Results can be filtered by education level (elementary, middle, high school, university, etc.). Essential for families evaluating neighborhoods or real estate purchases with education considerations.
Args: latitude: Center point latitude (decimal degrees) longitude: Center point longitude (decimal degrees) radius: Search radius in meters (defaults to 2000m/2km) education_levels: Optional list of specific education levels to filter by (e.g., ["elementary", "secondary", "university"])
Returns: List of educational institutions with: - Name and type - Distance from search point - Education levels offered - Contact information if available - Other relevant metadata
Inputs: latitude (required), longitude (required), radius, education_levels.
geocode_addressA
Convert an address or place name to geographic coordinates with detailed location information.
This tool takes a text description of a location (such as an address, landmark name, or place of interest) and returns its precise geographic coordinates along with rich metadata. The results can be used for mapping, navigation, location-based analysis, and as input to other geospatial tools.
Args: address: The address, place name, landmark, or description to geocode (e.g., "Empire State Building", "123 Main St, Springfield", "Golden Gate Park, San Francisco")
Returns: List of matching locations with: - Geographic coordinates (latitude/longitude) - Formatted address - Administrative boundaries (city, state, country) - OSM type and ID - Bounding box (if applicable) - Importance ranking
Inputs: address (required).
get_route_directionsA
Calculate detailed route directions between two geographic points.
This tool provides comprehensive routing information between two locations using OpenStreetMap/OSRM. The output can be minimized using the steps, overview, and annotations parameters to reduce the response size.
Args: from_latitude: Starting point latitude (decimal degrees) from_longitude: Starting point longitude (decimal degrees) to_latitude: Destination latitude (decimal degrees) to_longitude: Destination longitude (decimal degrees) ctx: Context (provided internally by MCP) mode: Transportation mode ("car", "bike", "foot") steps: Turn-by-turn instructions (True/False, Default: False) overview: Geometry output ("full", "simplified", "false"; Default: "simplified") annotations: Additional segment info (True/False, Default: False)
Returns: Dictionary with routing information (summary, directions, geometry, waypoints)
Example: { "from_latitude": 51.3334193, "from_longitude": 9.4540423, "to_latitude": 51.3295516, "to_longitude": 9.4576721, "mode": "car", "steps": false, "overview": "simplified", "annotations": false }
Inputs: to_latitude (required), to_longitude (required), from_latitude (required), from_longitude (required), +4 more.
reverse_geocodeA
Convert geographic coordinates to a detailed address and location description.
This tool takes a specific point on Earth (latitude and longitude) and returns comprehensive information about that location, including its address, nearby landmarks, administrative boundaries, and other contextual information. Useful for translating GPS coordinates into human-readable locations.
Args: latitude: The latitude coordinate (decimal degrees, WGS84) longitude: The longitude coordinate (decimal degrees, WGS84)
Returns: Detailed address and location information including: - Formatted address - Building, street, city, state, country - Administrative hierarchy - OSM metadata - Postal code and other relevant identifiers
Inputs: latitude (required), longitude (required).
search_categoryA
Search for specific types of places within a defined geographic area.
This tool allows targeted searches for places matching specific categories within a rectangular geographic region. It's particularly useful for filtering places by type (restaurants, schools, parks, etc.) within a neighborhood or city district. Results include complete location details and metadata about each matching place.
Args: category: Main OSM category to search for (e.g., "amenity", "shop", "tourism", "building") min_latitude: Southern boundary of search area (decimal degrees) min_longitude: Western boundary of search area (decimal degrees) max_latitude: Northern boundary of search area (decimal degrees) max_longitude: Eastern boundary of search area (decimal degrees) subcategories: Optional list of specific subcategories to filter by (e.g., ["restaurant", "cafe"])
Returns: Structured results including: - Query parameters - Count of matching places - List of matching places with coordinates, names, and metadata
Inputs: category (required), max_latitude (required), min_latitude (required), max_longitude (required), +2 more.
suggest_meeting_pointA
Find the optimal meeting place for multiple people coming from different locations.
This tool calculates a central meeting point based on the locations of multiple individuals, then recommends suitable venues near that central point. Ideal for planning social gatherings, business meetings, or any situation where multiple people need to converge from different starting points.
Args: locations: List of dictionaries, each containing the latitude and longitude of a person's location Example: [{"latitude": 37.7749, "longitude": -122.4194}, {"latitude": 37.3352, "longitude": -121.8811}] venue_type: Type of venue to suggest as a meeting point. Options include: "cafe", "restaurant", "bar", "library", "park", etc.
Returns: Meeting point recommendations including: - Calculated center point coordinates - List of suggested venues with names and details - Total number of matching venues in the area
Inputs: locations (required), venue_type.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Several tools have overlapping purposes: find_nearby_places, explore_area, and analyze_neighborhood all take coordinates and radius to return information about an area, differing mainly in aggregation style. search_category also overlaps with find_nearby_places. While descriptions add some detail, an agent could easily select the wrong tool for a generic nearby-places query.
Most tools follow a clear verb_noun pattern (e.g., find_parking_facilities, analyze_neighborhood, geocode_address). Names are lowercase with underscores and verbs are descriptive. Minor deviations like reverse_geocode and get_route_directions are still within the same convention, making the set predictable.
Twelve tools is well within the ideal 3–15 range. Each tool serves a distinct geospatial need, and the specialized find_* tools add focus without bloating the surface.
The set covers forward/reverse geocoding, place discovery, routing, commute analysis, and several specialized POI searches, covering the core geospatial workflows. Missing a specific 'place details by ID' tool is a minor gap, but agents can work around it with geocode_address or find_nearby_places.
Maintenance
Related MCP Connectors
Geospatial AI MCP server — satellite imagery, embeddings, weather, GNS governance
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
MCP server for Japan geodata: cadastral lot numbers (chiban) and reverse geocoding, for AI agents.
The Google Maps MCP server is a fully-managed server provided by the Maps Grounding Lite API that connects AI applications to Google Maps Platform services. It provides three main tools for building LLM applications: searching for places, looking up weather information, and computing routes with details like distance and travel time. The server acts as a proxy that translates Google Maps data into a format that AI applications can understand, enabling agents to accurately answer real-world location and travel queries.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that gives LLMs access to geographic data conversion tools, enabling transformations between different formats like WKT, GeoJSON, CSV, TopoJSON, and KML, as well as performing reverse geocoding.912 npm18MIT
- AlicenseBqualityDmaintenanceA comprehensive MCP server providing 30 tools for geocoding, routing, and OpenStreetMap data analysis. It enables AI assistants to search for locations, calculate travel routes, and perform quality assurance checks on map data.306MIT
- AlicenseNot gradedqualityCmaintenanceFree geospatial MCP server for AI agents, providing geocoding, reverse geocoding, POI search, and route planning using OpenStreetMap data via Nominatim, Overpass, and OSRM.GPL 3.0
- FlicenseAqualityDmaintenanceOSM-backed multimodal navigation MCP server enabling geocoding, route planning, POI discovery, and urban layout analysis. It provides a structured city graph to LLM apps without proprietary map APIs.8-