MCP Mapmyindia

Official

by bhuvnsh · TypeScript

MCP server for India maps - place search, nearby discovery, & directions powered by the Mappls API.

Map service for India enabling place search, nearby discovery, and directions.

README.md3 KBView on GitHub

mcp-mapmyindia

MCP Server for Mappls / MapMyIndia APIs

An MCP (Model Context Protocol) server that exposes Mappls / MapMyIndia APIs as tools for AI assistants like Claude. Enables geocoding, reverse geocoding, place search, nearby discovery, routing, and distance calculations — all focused on India's mapping data.

Tools

Tool	Description
`geocode`	Convert an address or place name to coordinates
`reverse_geocode`	Convert coordinates (lat/lng) to a human-readable address
`places_search`	Autocomplete and search for places by query string
`nearby`	Discover nearby places by keyword around a reference location
`directions`	Get turn-by-turn directions between two points (supports waypoints)
`distance_matrix`	Compute travel distance and time between multiple origins and destinations
`place_detail`	Fetch detailed information for a place using its eLoc (Mappls place ID)

Setup

Get API credentials

An API key (simpler, for personal/testing use)
OAuth client credentials (recommended for production)

Authentication

Set one of the following in your environment:

Option A — OAuth (Client Credentials): RECOMMENDED

bash

export MAPPLS_CLIENT_ID=your_client_id
export MAPPLS_CLIENT_SECRET=your_client_secret

Option B — API Key:

bash

export MAPPLS_API_KEY=your_api_key_here

Usage with Claude Desktop

Add to your claude_desktop_config.json:

OAuth

{
  "mcpServers": {
    "mapmyindia": {
      "command": "npx",
      "args": ["-y", "@bhuvsh/mcp-mapmyindia"],
      "env": {
        "MAPPLS_CLIENT_ID": "your_client_id",
        "MAPPLS_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Or with API key:

json

{
  "mcpServers": {
    "mapmyindia": {
      "command": "npx",
      "args": ["-y", "@bhuvnsh/mcp-mapmyindia"],
      "env": {
        "MAPPLS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Development

bash

# Clone and install
git clone https://github.com/bhuvnsh/mcp-mappls.git
cd mcp-mappls
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode (dev)
npm run dev

Requirements

Node.js >= 18
A Mappls API key or OAuth client credentials

Contributing

Contributions are welcome. Please open an issue first to discuss what you'd like to change. Pull requests should include tests.

License

MIT

Install

Configuration

Environment variables

MAPPLS_API_KEYsecret

Mappls API key — get one free at https://apis.mappls.com

MAPPLS_CLIENT_ID

Mappls OAuth client ID (alternative to API key)

MAPPLS_CLIENT_SECRETsecret

Mappls OAuth client secret (used with CLIENT_ID)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-mapmyindia": {
      "command": "npx",
      "args": [
        "-y",
        "@bhuvnsh/mcp-mapmyindia@0.1.0"
      ],
      "env": {
        "MAPPLS_API_KEY": "<YOUR_MAPPLS_API_KEY>",
        "MAPPLS_CLIENT_ID": "<YOUR_MAPPLS_CLIENT_ID>",
        "MAPPLS_CLIENT_SECRET": "<YOUR_MAPPLS_CLIENT_SECRET>"
      }
    }
  }
}