Skip to content
MCP server

INAVI Maps API

Calls INAVI Maps APIs for places, geocoding and routes, shown on a map in chat

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.0.4
Listing updated
2 days ago

About INAVI Maps API

INAVI Maps API is an open-source MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

Where the sibling docs server only explains the INAVI Maps APIs, this one makes the calls. An assistant can search places by name, category or address, run nearby searches, geocode and reverse geocode, and plan routes for cars (with real-time traffic and departure-time prediction), walking and scooters. It can also optimize the order of waypoints and return distance and time matrices.

Results can be drawn as an interactive map inside the conversation using MCP Apps. The README notes this works only in hosts that support MCP Apps and was checked in Claude Desktop; elsewhere the tool calls still work and only the map is missing.

The server will not start without an INAVI Maps API key, supplied through the INAVI_APPKEY environment variable. It runs locally over npx on Node.js 22 or newer and is MIT licensed. The README is in Korean and aimed at South Korean locations.

Install

Run in a terminal

claude mcp add inavi-api-mcp --env INAVI_APPKEY='<INAVI_APPKEY>' -- npx -y @inavi-maps/api-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "inavi-api-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@inavi-maps/api-mcp-server"
      ],
      "env": {
        "INAVI_APPKEY": "<INAVI_APPKEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "inavi-api-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@inavi-maps/api-mcp-server"
      ],
      "env": {
        "INAVI_APPKEY": "<INAVI_APPKEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "inavi-api-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@inavi-maps/api-mcp-server"
      ],
      "env": {
        "INAVI_APPKEY": "<INAVI_APPKEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "inavi-api-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@inavi-maps/api-mcp-server"
      ],
      "env": {
        "INAVI_APPKEY": "<INAVI_APPKEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "inavi-api-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@inavi-maps/api-mcp-server"
      ],
      "env": {
        "INAVI_APPKEY": "<INAVI_APPKEY>"
      }
    }
  }
}

Configuration

  • INAVI_APPKEYINAVI Maps API KeyRequired

What it does

Place and address search
Search by name, category or address, plus nearby category search.
Geocoding both ways
Convert addresses to coordinates and back.
Multi-mode routes
Car routes with traffic and departure time, plus walking and scooter routes.
Waypoint ordering
Optimizes stop order and returns distance and time matrices.
Map in the chat
Shows results as an interactive map in MCP Apps hosts.

Good for

  • Find convenience stores within 500 m of a station
  • Get the address for a pair of coordinates
  • Estimate travel time for a morning departure
  • Plan the best order for several delivery stops

Pricing

Open source

MIT-licensed server; needs an INAVI Maps API key

Prices change. Check mapsapi.inavisys.com before you buy.

INAVI Maps API FAQ

Is an API key required?

Yes. The server will not start without INAVI_APPKEY.

Where does the map appear?

In hosts that support MCP Apps; the README says it was verified in Claude Desktop.

What if my host cannot show maps?

Tool calls and answers still work; only the map is not drawn.

What licence is it under?

The README shows an MIT badge.

Is INAVI Maps API free?

Yes. INAVI Maps API is open source, so you can use and self-host it for free.

How do I add INAVI Maps API to Claude Code?

Run this command in your terminal: claude mcp add inavi-api-mcp --env INAVI_APPKEY='<INAVI_APPKEY>' -- npx -y @inavi-maps/api-mcp-server

What are the best alternatives to INAVI Maps API?

The closest alternatives to INAVI Maps API are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to INAVI Maps API

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools