Nominatim MCP Server

by cyanheadsio.github.cyanheads/nominatim-mcp-serverv0.1.8

Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.

6Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Deprecated6d ago

Install Nominatim MCP server

claude mcp add nominatim -- npx -y @cyanheads/nominatim-mcp-server run start:stdio

{
  "mcpServers": {
    "nominatim": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/nominatim-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "nominatim": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/nominatim-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "nominatim": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/nominatim-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "nominatim": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/nominatim-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
NOMINATIM_BASE_URL	—	—	Nominatim API base URL. Override to use a private or mirror instance.
NOMINATIM_USER_AGENT	—	—	User-Agent sent to Nominatim and Overpass. Required by usage policy.
OVERPASS_BASE_URL	—	—	Overpass API endpoint URL. Override to use a mirror or private instance.
MCP_LOG_LEVEL	—	—	Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_HTTP_HOST	—	—	The hostname for the HTTP server.
MCP_HTTP_PORT	—	—	The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH	—	—	The endpoint path for the MCP server.
MCP_PUBLIC_URL	—	—	Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).
MCP_AUTH_MODE	—	—	Authentication mode to use: 'none', 'jwt', or 'oauth'.

Remote endpoints

streamable-httphttps://nominatim.caseyjhand.com/mcp

Freshness

Deprecated — last maintenance signal 6d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-03 · 6d ago · GitHub
Latest release
2026-10-03 · 6d ago · GitHub · v0.6.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-30 · 40d ago · official registry · v0.1.8

FAQ

›How do I install the Nominatim MCP server in Claude Code?

Run: claude mcp add nominatim -- npx -y @cyanheads/nominatim-mcp-server run start:stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Nominatim require an API key?

No required environment variables are declared in its published metadata.

›Can I use Nominatim as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Nominatim in the official MCP registry?

Yes, as io.github.cyanheads/nominatim-mcp-server.