Skip to content
MCP server

Apple Maps

Read your saved Apple Maps favourites, Guides and recents, with writes off by default

Runs locallyStatus and history
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-maps

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-apple-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-maps"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-apple-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-maps"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  2. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel
  3. Fifty Asks

    MCP server

    Let an agent book a free AI-visibility check or a 15-minute call for a local business

    • 10 tools
    • Remote
    • Free
    • Maps and travel
  4. Gangway AIS

    MCP server

    Vessel positions, port calls and anchorage waiting times from licensed AIS data

    • 21 tools
    • Remote
    • Freemium
    • Freight and logistics
  5. Goyondo

    MCP server

    Agent-native trip planner where your AI builds the itinerary and Goyondo stores it

    • Remote
    • Freemium
    • Maps and travel