# INAVI Maps API

> INAVI Maps API is an open-source MCP server for maps and travel. Calls INAVI Maps APIs for places, geocoding and routes, shown on a map in chat. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://mapsapi.inavisys.com
- **Repository:** https://github.com/inavi-systems/inavi-api-mcp
- **MCP Registry name:** io.github.inavi-systems/inavi-api-mcp
- **Categories:** maps and travel, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/inavi-maps-api
