Geocoding, walking/driving/cycling distances, route optimization, isochrones and POI search on OSM
Connect Runs on your machine
claude mcp add osm-mcp -e OSM_USER_AGENT=<OSM_USER_AGENT> -e ORS_API_KEY=<ORS_API_KEY> -e OSM_ALLOW_TOOLS=<OSM_ALLOW_TOOLS> -e OSM_DENY_TOOLS=<OSM_DENY_TOOLS> -- npx -y [email protected]{
"mcpServers": {
"osm-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"OSM_USER_AGENT": "<OSM_USER_AGENT>",
"ORS_API_KEY": "<ORS_API_KEY>",
"OSM_ALLOW_TOOLS": "<OSM_ALLOW_TOOLS>",
"OSM_DENY_TOOLS": "<OSM_DENY_TOOLS>"
}
}
}
}{
"mcpServers": {
"osm-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"OSM_USER_AGENT": "<OSM_USER_AGENT>",
"ORS_API_KEY": "<ORS_API_KEY>",
"OSM_ALLOW_TOOLS": "<OSM_ALLOW_TOOLS>",
"OSM_DENY_TOOLS": "<OSM_DENY_TOOLS>"
}
}
}
}{
"servers": {
"osm-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"OSM_USER_AGENT": "<OSM_USER_AGENT>",
"ORS_API_KEY": "<ORS_API_KEY>",
"OSM_ALLOW_TOOLS": "<OSM_ALLOW_TOOLS>",
"OSM_DENY_TOOLS": "<OSM_DENY_TOOLS>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
OSM_USER_AGENTOptional | Identifying User-Agent sent to all OSM services (Nominatim requires one) |
ORS_API_KEYOptional, secret | Optional OpenRouteService key; switches routing/matrix/isochrones to ORS |
OSM_ALLOW_TOOLSOptional | Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools) |
OSM_DENY_TOOLSOptional | Comma-separated tool names or list_* prefixes to remove from whatever OSM_ALLOW_TOOLS left |
Details
| Package | [email protected] (NPM, stdio) |
| Package | ghcr.io/ni-c/osm-mcp:0.3.2 (OCI, stdio) |
| First published | 15 Oct 2026 |
| Last updated | 15 Oct 2026 |
| Registry name | io.github.ni-c/osm-mcp |
More search and web servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.