Apple Maps — Claude Code MCP server: what it does, how to install
Enables AI models to find places and estimate routes on macOS. Useful for generating quick navigation links in your coding agent.
claude mcp add apple-maps-mcp -- uvx apple-maps-mcpWhat Apple Maps does
This MCP server hooks your AI client into Apple Maps on macOS. The agent looks up business locations and calculates driving routes. It also returns direct map URLs for navigation.
The server requires Python 3.11+ and runs on macOS. Its Swift helper depends on Xcode command line tools, without which the tool fails to build. macOS shows no privacy popups for this domain. You can verify discovery via maps_health.
Running locally does not mean your queries stay on your machine. The MCP host routinely sends map responses up to the model provider.
What it helps with
- look up place addresses and coordinates through Apple Maps
- calculate driving routes and travel time estimates
- create direct navigation links for locations
Example prompts for the agent
- Search for coffee shops near the main station and share Apple Maps links
- Calculate the driving route between the airport and downtown
- Inspect the maps integration status with
maps_health
How to install Apple Maps
Platform CLI
claude mcp add apple-maps-mcp -- uvx apple-maps-mcpuvx runs the command named after the package; if the README names another one, use uvx --from apple-maps-mcp <command>
Platform CLI
codex mcp add applemaps-mcp -- uvx apple-maps-mcpuvx runs the command named after the package; if the README names another one, use uvx --from apple-maps-mcp <command>
Config file
{
"mcpServers": {
"applemaps-mcp": {
"command": "uvx",
"args": [
"apple-maps-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from apple-maps-mcp <command>
Config file
{
"servers": {
"applemaps-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-maps-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from apple-maps-mcp <command>
Platform CLI
gemini mcp add applemaps-mcp uvx apple-maps-mcpuvx runs the command named after the package; if the README names another one, use uvx --from apple-maps-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Apple Maps
How to install Apple Maps in Claude Code?
Register the server by running claude mcp add apple-maps-mcp -- uvx apple-maps-mcp. Restart the client after registration finishes.
What does Apple Maps do?
It gives your AI assistant access to search locations, calculate travel routes, and create navigation links on macOS.
What system dependencies are required?
You need macOS, Python 3.11+, and Xcode command line tools to support the internal Swift helper. It does not trigger macOS privacy permission prompts.
