English Français العربية

io.github.bhuvnsh/mcp-mapmyindia

Official registry Search and web

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @bhuvnsh/mcp-mapmyindia
Claude Code 
claude mcp add mcp-mapmyindia -e 'MAPPLS_API_KEY=<your mappls_api_key>' -e 'MAPPLS_CLIENT_ID=<MAPPLS_CLIENT_ID>' -e 'MAPPLS_CLIENT_SECRET=<your mappls_client_secret>' -- npx -y @bhuvnsh/mcp-mapmyindia@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-mapmyindia": {
            "command": "npx",
            "args": [
                "-y",
                "@bhuvnsh/mcp-mapmyindia@0.1.0"
            ],
            "env": {
                "MAPPLS_API_KEY": "<your mappls_api_key>",
                "MAPPLS_CLIENT_ID": "<MAPPLS_CLIENT_ID>",
                "MAPPLS_CLIENT_SECRET": "<your mappls_client_secret>"
            }
        }
    }
}

Environment variables

  • MAPPLS_API_KEY secret Mappls API key — get one free at https://apis.mappls.com
  • MAPPLS_CLIENT_ID Mappls OAuth client ID (alternative to API key)
  • MAPPLS_CLIENT_SECRET secret Mappls OAuth client secret (used with CLIENT_ID)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-mapmyindia
  2. Tools
  3. Setup
  4. Usage with Claude Desktop
  5. Development
  6. Contributing
  7. License

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

ToolDescription
geocodeConvert an address or place name to coordinates
reverse_geocodeConvert coordinates (lat/lng) to a human-readable address
places_searchAutocomplete and search for places by query string
nearbyDiscover nearby places by keyword around a reference location
directionsGet turn-by-turn directions between two points (supports waypoints)
distance_matrixCompute travel distance and time between multiple origins and destinations
place_detailFetch detailed information for a place using its eLoc (Mappls place ID)

Setup

Get API credentials

Register at https://apis.mappls.com to get either:

  • 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

export MAPPLS_CLIENT_ID=your_client_id
export MAPPLS_CLIENT_SECRET=your_client_secret

Option B — API Key:

export MAPPLS_API_KEY=your_api_key_here

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "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:

{
  "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

# 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

Frequently asked questions

What is io.github.bhuvnsh/mcp-mapmyindia?

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

How do I install io.github.bhuvnsh/mcp-mapmyindia?

It runs on your machine. In Claude Code: claude mcp add mcp-mapmyindia -e 'MAPPLS_API_KEY=<your mappls_api_key>' -e 'MAPPLS_CLIENT_ID=<MAPPLS_CLIENT_ID>' -e 'MAPPLS_CLIENT_SECRET=<your mappls_client_secret>' -- npx -y @bhuvnsh/mcp-mapmyindia@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.bhuvnsh/mcp-mapmyindia need an API key?

Yes. It expects MAPPLS_API_KEY, MAPPLS_CLIENT_SECRET, which you set in its configuration.

Is io.github.bhuvnsh/mcp-mapmyindia open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.bhuvnsh/mcp-mapmyindia?

It is published by bhuvnsh. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.