# Apple Maps

> Apple Maps is an open-source MCP server for maps and travel. Read your saved Apple Maps favourites, Guides and recents, with writes off by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Website:** https://cupertino.mgcrea.io
- **Repository:** https://github.com/mgcrea/cupertino/tree/HEAD/packages/maps
- **MCP Registry name:** io.github.mgcrea/mcp-apple-maps
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-apple-maps -- npx -y @mgcrea/mcp-apple-maps
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-maps"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-apple-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-maps"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-apple-maps": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-maps"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-apple-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-maps"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-apple-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-maps"
      ]
    }
  }
}
```

## Tools

- `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.

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

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/apple-maps-2
