Skip to main content
Glama

OpenStreetMap (OSM) MCP Server

An OpenStreetMap MCP server implementation that enhances LLM capabilities with location-based services and geospatial data.

Demo

Meeting Point Optimization

Meeting Point Use Case

Neighborhood Analysis

Neighborhood Analysis Use Case

Parking Search Use Case

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 address

  • location://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 coordinates

  • reverse_geocode: Convert coordinates to human-readable addresses

  • find_nearby_places: Discover points of interest near a location

  • get_route_directions: Get turn-by-turn directions between locations

  • search_category: Find places of specific categories in an area

  • suggest_meeting_point: Find optimal meeting spots for multiple people

  • explore_area: Get comprehensive data about a neighborhood

  • find_schools_nearby: Locate educational institutions near a specific location

  • analyze_commute: Compare transportation options between home and work

  • find_ev_charging_stations: Locate EV charging infrastructure with filtering

  • analyze_neighborhood: Evaluate neighborhood livability for real estate

  • find_parking_facilities: Locate parking options near a destination

Local Testing

Running the Server

To run the server locally:

  1. Install the package in development mode:

pip install -e .
  1. Start the server:

osm-mcp-server
  1. The 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.py

This 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.py

This 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:

  1. Import the MCP client:

from mcp.client import Client
  1. Initialize the client with your server URL:

client = Client("http://localhost:8000")
  1. 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:

  1. Sync dependencies and update lockfile:

uv sync
  1. Build package distributions:

uv build

This will create source and wheel distributions in the dist/ directory.

  1. Publish to PyPI:

uv publish

Note: 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-server

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

Available Tools

12 tools
analyze_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

    A3.9/5.0

    Scored across 12 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A 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.
      30
      6
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Free 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
    • F
      license
      A
      quality
      D
      maintenance
      OSM-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
      -