# OpenStreetMap

> OpenStreetMap is an open-source MCP server for maps and travel. OpenStreetMap geocoding, routes, isochrones and POI search with no API key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://osm-mcp.ni-c.de
- **Repository:** https://github.com/ni-c/osm-mcp
- **MCP Registry name:** io.github.ni-c/osm-mcp
- **Categories:** maps and travel
- **Listing updated:** 2026-11-15

## About

osm-mcp is for travel-planning questions such as how long a walk takes, in what order to visit five places, or what you can reach in 15 minutes on foot. Its eleven read-only tools use free public OpenStreetMap services for geocoding, walking, driving and cycling distances, multi-stop route optimisation, isochrones and point-of-interest search.

Its selling point is correct non-car routing: the public OSRM demo servers return car routes unless the FOSSGIS routed-foot, routed-bike and routed-car prefixes are used, and the author says many OSM servers miss this. It also enforces the services' usage policies in code with rate limits (1 request per second for Nominatim and OSRM), a mandatory identifying User-Agent, caching, capped Overpass concurrency and failover to another Overpass endpoint. Photon geocoding is optional, as is an OpenRouteService key.

It deliberately does not write to OpenStreetMap, render maps, track GPS, provide traffic or do bulk geocoding. It runs over stdio from npm or a container and needs Node.js 24 or newer; OSM_ALLOW_TOOLS=essential loads a curated six.

## Features

- **Correct foot and bike routes:** Uses FOSSGIS profile prefixes so walking queries are not answered with car times.
- **Isochrones:** Shows what is reachable within a given travel time.
- **Multi-stop optimisation:** Orders several places into an efficient route.
- **POI search:** Finds places of interest through OpenStreetMap data.
- **Policy-compliant limits:** Rate limiting, caching and a required User-Agent are built in.
- **Tool filtering:** Allow and deny lists, or an essential preset of six tools.

## Good for

- Estimate walking time between two landmarks
- Order a list of sights into a route
- Find what is within 15 minutes on foot of a hotel
- Find a fair meeting spot for three people
- Geocode a place name

## Install

### Claude Code (Terminal)

```sh
claude mcp add osm-mcp --env ORS_API_KEY='<ORS_API_KEY>' -- npx -y osm-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "osm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "osm-mcp"
      ],
      "env": {
        "ORS_API_KEY": "<ORS_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "osm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "osm-mcp"
      ],
      "env": {
        "ORS_API_KEY": "<ORS_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "osm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "osm-mcp"
      ],
      "env": {
        "ORS_API_KEY": "<ORS_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "osm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "osm-mcp"
      ],
      "env": {
        "ORS_API_KEY": "<ORS_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "osm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "osm-mcp"
      ],
      "env": {
        "ORS_API_KEY": "<ORS_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Do I need an API key?

No. Every backend is a free public OSM service; an OpenRouteService key is optional.

### Can it edit OpenStreetMap?

No. All 11 tools are read-only and the write API is not wired up.

### Is it suitable for heavy use?

Not on the public services; for heavy or commercial use, self-host the backends and point the *_BASE_URL variables at them.

### What does it need to run?

Node.js 24 or newer and internet access to the public OSM services.

### Is OpenStreetMap free?

Yes. OpenStreetMap is open source, so you can use and self-host it for free.

### How do I add OpenStreetMap to Claude Code?

Run this command in your terminal: claude mcp add osm-mcp --env ORS_API_KEY='<ORS_API_KEY>' -- npx -y osm-mcp

### What are the best alternatives to OpenStreetMap?

The closest alternatives to OpenStreetMap are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/openstreetmap
