What are the requirements for OneMap?

OneMap requires the following environment variables: ONEMAP_EMAIL (required), ONEMAP_EMAIL_PASSWORD (required). You'll also need a compatible MCP client like Claude Desktop or Claude Code.

Is OneMap free to use?

Yes, OneMap is open source and free to use. You can find the source code on GitHub.

What MCP clients support OneMap?

OneMap works with any MCP-compatible client including Claude Desktop (Anthropic's official desktop app), Claude Code (CLI tool), Cursor, and other editors with MCP support.

How do I configure OneMap?

Configure OneMap by adding it to your MCP client's config file. The setup block at the top of this page generates a ready-to-paste config for Claude Code, Cursor, Codex, Windsurf, and Claude Desktop.

OneMap MCP Server

Q: What tools does OneMap provide?

search: Search for addresses, buildings, and postal codes.. reverse_geocode_wgs84: Get address from WGS84 coordinates.. route_walk_drive_cycle: Calculate walking, driving, cycling, or barrier-free routes.. get_nearby_mrt_stations: Find nearby MRT/LRT stations.. get_static_map: Generate map images with optional overlays..

Q: How do I install OneMap?

Install OneMap by running: pip install -r requirements.txt && python server.py

Comprehensive access to Singapore's OneMap APIs for AI assistants

search singapore geospatial mapping routing

README.md

OneMap MCP Server v2

A Python-based MCP (Model Context Protocol) server that provides comprehensive access to Singapore's OneMap APIs. Built with FastMCP for easy integration with AI assistants and Microsoft AI Foundry.

Features

This server exposes 35+ tools across 10 API categories:

Search - Address and location search
Reverse Geocode - Convert coordinates to addresses (WGS84 and SVY21)
Routing - Public transport, driving, walking, cycling, barrier-free routes
Coordinate Converters - EPSG 4326 (WGS84), EPSG 3414 (SVY21), EPSG 3857
Themes - Access 100+ thematic layers for locations, amenities, boundaries
Planning Area - Singapore's 55 planning area information
Population Query - Demographics and statistics by planning area
Nearby Transport - Find nearby MRT/LRT stations and bus stops
Static Map - Generate static map images with optional overlays

Prerequisites

Python 3.11+
OneMap Account (register at OneMap API)

Installation

Local Development

Clone the repository:

cd onemap-mcp

Create a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Install dependencies:

pip install -r requirements.txt

Create .env file with your credentials:

cp .env.example .env
# Edit .env with your OneMap credentials

Run the server:

python server.py

Environment Variables

Create a .env file with:

ONEMAP_EMAIL=your_email@example.com
ONEMAP_EMAIL_PASSWORD=your_password

Docker Deployment

Build the Docker image:

docker build -t onemap-mcp .

Run the container:

docker run -d \
  -e ONEMAP_EMAIL="your_email@example.com" \
  -e ONEMAP_EMAIL_PASSWORD="your_password" \
  --name onemap-mcp \
  onemap-mcp

Available Tools

Search & Geocoding

Tool	Description
`search`	Search for addresses, buildings, postal codes
`reverse_geocode_wgs84`	Get address from WGS84 coordinates
`reverse_geocode_svy21`	Get address from SVY21 coordinates

Routing

Tool	Description
`route_walk_drive_cycle`	Walking, driving, cycling, barrier-free routes
`route_public_transport`	Bus and MRT routes with fare info

Coordinate Conversion

Tool	Description
`convert_4326_to_3857`	WGS84 → Web Mercator
`convert_4326_to_3414`	WGS84 → SVY21
`convert_3414_to_4326`	SVY21 → WGS84
`convert_3414_to_3857`	SVY21 → Web Mercator
`convert_3857_to_4326`	Web Mercator → WGS84
`convert_3857_to_3414`	Web Mercator → SVY21

Themes

Tool	Description
`get_all_themes_info`	List all 100+ thematic layers
`get_theme_info`	Get info about a specific theme
`check_theme_status`	Check if theme was updated
`retrieve_theme`	Retrieve theme data

Planning Areas

Tool	Description
`get_all_planning_areas`	Get all 55 planning area polygons
`get_planning_area_names`	List planning area names
`get_planning_area_by_location`	Get planning area for a location

Population Data

Tool	Description
`get_population_age_group`	Population by age
`get_ethnic_distribution`	Ethnic group distribution
`get_economic_status`	Employment statistics
`get_household_monthly_income`	Income distribution
`get_education_status`	Education levels
... and more

Transport

Tool	Description
`get_nearby_mrt_stations`	Find nearby MRT/LRT stations
`get_nearby_bus_stops`	Find nearby bus stops

Static Maps

Tool	Description
`get_static_map`	Generate map images with overlays

Usage Examples

Search for a location

# Search for Marina Bay Sands
result = await search(search_value="Marina Bay Sands")

Get route directions

# Driving route from Changi to Orchard
result = await route_walk_drive_cycle(
    start_lat=1.3644,
    start_lon=103.9915,
    end_lat=1.3048,
    end_lon=103.8318,
    route_type="drive"
)

Find nearby MRT stations

result = await get_nearby_mrt_stations(
    latitude=1.3521,
    longitude=103.8198,
    radius_in_meters=1000
)

Project Structure

onemap-mcp/
├── server.py          # FastMCP server with all tools
├── mcp.json           # MCP manifest
├── tools.json         # Tool definitions for AI Foundry
├── onemap/
│   ├── __init__.py
│   └── utils.py       # HTTP client and utility functions
├── .env               # Your credentials (not in git)
├── .env.example       # Template for credentials
├── Dockerfile
├── requirements.txt
└── README.md

Deployment to Azure

Azure Container Apps

# Build and push to Azure Container Registry
az acr b

Tools 5

searchSearch for addresses, buildings, and postal codes.

reverse_geocode_wgs84Get address from WGS84 coordinates.

route_walk_drive_cycleCalculate walking, driving, cycling, or barrier-free routes.

get_nearby_mrt_stationsFind nearby MRT/LRT stations.

get_static_mapGenerate map images with optional overlays.

Environment Variables

ONEMAP_EMAILrequiredEmail address registered with OneMap API

ONEMAP_EMAIL_PASSWORDrequiredPassword for OneMap API account

Try it

→Search for the address of Marina Bay Sands in Singapore.

→Calculate a driving route from Changi Airport to Orchard Road.

→Find all MRT stations within 1000 meters of my current location at 1.3521, 103.8198.

→What is the demographic age distribution in the Tampines planning area?

Manual setup required. The maintainer's config contains paths only you know — edit the placeholders below before adding it to Claude Code.

Prepare the server locally

Run this once before adding it to Claude Code.

pip install -r requirements.txt
python server.py

Register it in Claude Code

claude mcp add -e "ONEMAP_EMAIL=${ONEMAP_EMAIL}" -e "ONEMAP_EMAIL_PASSWORD=${ONEMAP_EMAIL_PASSWORD}" onemap -- python /path/to/onemap-mcp/server.py

Replace any placeholder paths in the command with the real path on your machine.

Required:ONEMAP_EMAILONEMAP_EMAIL_PASSWORD

At a glance

Repository: linzele/mcp-onemap ↗
Author: linzele ↗
Updated: Apr 5, 2026

Frequently Asked Questions

What are the key features of OneMap?

Search for Singapore addresses, buildings, and postal codes. Calculate multi-modal routes including public transport, driving, and cycling. Convert coordinates between WGS84, SVY21, and Web Mercator systems. Access 100+ thematic layers and Singapore planning area data. Retrieve population statistics including age, income, and education levels.

What can I use OneMap for?

Building location-aware AI agents for Singapore-based logistics. Automating urban planning research using demographic and thematic data. Integrating real-time public transport routing into AI-powered travel assistants. Performing geospatial data analysis and coordinate conversions for mapping projects.

How do I install OneMap?

Install OneMap by running: pip install -r requirements.txt && python server.py

What MCP clients work with OneMap?

OneMap works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep OneMap docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare

OneMap MCP Server v2

Features

Prerequisites

Installation

Local Development

Environment Variables

Docker Deployment

Available Tools

Search & Geocoding

Routing

Coordinate Conversion

Themes

Planning Areas

Population Data

Transport

Static Maps

Usage Examples

Search for a location

Get route directions

Find nearby MRT stations

Project Structure

Deployment to Azure

Azure Container Apps

Tools 5

Environment Variables

Try it

Frequently Asked Questions

Turn this server into reusable context

Related MCP Servers