Apple Maps
Read your saved Apple Maps favourites, Guides and recents, with writes off by default
- Pricing
- Open source
- Platforms
- macOS, CLI
- Runs
- Locally
- Version
- 1.38.0
- Listing updated
- 2 days ago
About Apple Maps
Apple Maps is an open-source MCP server for maps and travel. It runs locally on your machine and is started by your AI client.
Saved places are the scope: this server reads Favourites, Guides (collections) and recents from the Maps app's local Core Data store, returning names, addresses and real coordinates. It does not search Apple's map of the world, geocode addresses, give directions or compute travel times, since those are network calls to Apple's services rather than data on your disk.
Run from npm it only reads. Five write tools, for pinning or unpinning a favourite, saving or removing a saved place and filing one in a Guide, exist only when the server is hosted inside the Cupertino menu-bar app with APPLE_MAPS_ALLOW_WRITES on. With writes off those tools are not registered at all, so a client is never told they exist. The README explains that an earlier route which wrote favourites straight into the store was removed on 2026-11-11 after the inserts failed to sync to iCloud. Resolving a new place by name can take tens of seconds and leaves it in Recents, and sync across devices was measured only on one Maps model version.
The Cupertino project bundles MCP servers for other Mac apps behind one Full Disk Access grant, needs macOS 26 or later, and offers a 30-minute trial with no account; it states the servers are MIT licensed and unofficial. This package installs from npm as @mgcrea/mcp-apple-maps.
Install
Run in a terminal
claude mcp add mcp-apple-maps -- npx -y @mgcrea/mcp-apple-mapsAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-apple-maps": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-maps"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-apple-maps": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-maps"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-apple-maps": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-maps"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-apple-maps": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-maps"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-apple-maps": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-maps"
]
}
}
}Configuration
APPLE_MAPS_ALLOW_WRITESRegister the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- apple_maps_list_favorites
- List the places saved as favourites.
- apple_maps_list_collections
- List the Guides.
- apple_maps_list_collection_places
- List what is filed in one Guide.
- apple_maps_list_unfiled_places
- List saved places filed in no Guide.
- apple_maps_list_recents
- List where you have looked recently.
- apple_maps_search_places
- Search favourites, Guides and recents by name, label or address.
- apple_maps_get_place
- Get one place by ref.
- apple_maps_diagnostics
- Report what opened, which columns resolved and what it cannot do.
- apple_maps_add_favorite
- Pin a place (needs Cupertino with writes on).
- apple_maps_remove_favorite
- Unpin a place by ref.
- apple_maps_save_place
- Save a place to the library in no Guide.
- apple_maps_remove_saved_place
- Remove a saved place by ref.
- apple_maps_add_place_to_guide
- File a saved or new place in an existing Guide.
What it does
- Favourites and recents
- Lists pinned favourites and recently viewed places.
- Guides
- Lists Guides and the places filed in each one, plus unfiled saved places.
- Combined search
- Searches favourites, Guides and recents at once by name, label or address.
- Real coordinates
- Returns addresses and coordinates from the local store.
- Diagnostics
- Reports what opened, which columns resolved and what it cannot do.
- Gated writes
- Write tools are unregistered unless hosted in Cupertino with writes enabled.
Good for
- Ask which places are saved in a travel Guide
- Find a saved address by name
- List where you looked recently
- Pin or file a place in a Guide through Cupertino
Pricing
Open source
Servers are MIT licensed; Cupertino has a 30-minute trial
Prices change. Check cupertino.mgcrea.io before you buy.
Apple Maps FAQ
Can it give directions or search the map?
No. It reads only places saved on this Mac and does not geocode, route or compute travel times.
Does the npm package write to Maps?
No. Run from npm it registers no write tool, whatever APPLE_MAPS_ALLOW_WRITES says.
What do I need?
A Mac; Cupertino requires macOS 26 or later and a Full Disk Access grant.
Is it from Apple?
No. The project states it is unofficial and not affiliated with Apple.
Is Apple Maps free?
Yes. Apple Maps is open source, so you can use and self-host it for free.
How do I add Apple Maps to Claude Code?
Run this command in your terminal: claude mcp add mcp-apple-maps -- npx -y @mgcrea/mcp-apple-maps
What are the best alternatives to Apple Maps?
The closest alternatives to Apple Maps are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.
Alternatives to Apple Maps

Tutu eSIM
MCP serverLive travel eSIM plans, prices and roaming costs for 190+ countries
- 5 tools
- Remote
- Paid
- Maps and travel

Shanghai Streets Travel Guide
MCP serverCurated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang
- 9 tools
- Remote
- Free
- Maps and travel
Fifty Asks
MCP serverLet an agent book a free AI-visibility check or a 15-minute call for a local business
- 10 tools
- Remote
- Free
- Maps and travel

Gangway AIS
MCP serverVessel positions, port calls and anchorage waiting times from licensed AIS data
- 21 tools
- Remote
- Freemium
- Freight and logistics
Public tour and ticket search for Gramado, Calafate, Bariloche, Ushuaia and Cartagena
- 3 tools
- Remote
- Free
- Maps and travel

Goyondo
MCP serverAgent-native trip planner where your AI builds the itinerary and Goyondo stores it
- Remote
- Freemium
- Maps and travel