Apple Maps

io.github.JonathanRReedPublished by GitHub account JonathanRReedv1.1.6Updated Nov 7, 2026

Search places, estimate routes, and build Apple Maps links on macOS.

VerifiedSTDIODesktop onlyLocation & LifestyleProductivity & Workflow

Overview

AI-generated overview

Local macOS MCP server that lets an assistant search Apple Maps places, estimate routes, build Maps links and open directions.

What you can do
  • Search Apple Maps for matching places
  • Get route details, distance and travel time between an origin and destination
  • Build Apple Maps URLs for a destination or route, and open directions in the Maps app
  • Check server health and get guidance on macOS helper permissions
  • Discover and load tool schemas via search_tools and get_tool_info, plus prompt fallbacks
When to use it
Useful on a Mac when the assistant needs place lookup, travel-time estimates or Maps links, for example when travel or routing affects calendar, reminders, messages or mail actions. The README advises confirming origin, destination and transport mode before writing time-sensitive plans.
Requirements
Runs locally on macOS only, over stdio by default. Needs uv (uvx apple-maps-mcp from PyPI) or a clone with Python 3.11+; a local Swift helper is compiled, which may require Xcode command line tools. No accounts, API keys or environment variables are declared. Streamable HTTP is optional via APPLE_MAPS_MCP_TRANSPORT.
Before you install
It can open directions in the Apple Maps app, which changes what is shown on the user's machine. The local helper must compile, and failures are handled by installing Xcode command line tools. Place searches and routes are sent to Apple's Maps services.

Installation

In SourceWeft

  1. Open Apple Maps in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Apple Maps MCP

Local MCP server for Apple Maps search and routing on macOS.

Capabilities

  • search for places
  • estimate route distance and travel time
  • build Apple Maps links
  • open directions in Apple Maps
  • resource: maps://status
  • prompt: maps_plan_route
  • tool discovery helpers search_tools and get_tool_info for context-constrained clients

Install On This Mac

Quick start (uvx, from PyPI)

With uv installed:

bash
uvx apple-maps-mcp

No clone, no venv management.

From a clone
bash
git clone https://github.com/JonathanRReed/Apple-MCPs.gitcd Apple-MCPsuv sync --all-packages

This builds one workspace environment with every server's entry point in .venv/bin (for example .venv/bin/apple-maps-mcp). You can also point an MCP client at AppleMaps-MCP/start.sh, which prefers uv run and falls back to a plain venv bootstrap (Python 3.11+ required).

Install In AI Agents

json
{  "mcpServers": {    "apple-maps": {      "command": "uvx",      "args": ["apple-maps-mcp"],      "env": {}    }  }}

Running from a clone instead? Use /path/to/Apple-MCPs/AppleMaps-MCP/start.sh as the command with empty args.

Claude Code:

bash
claude mcp add --transport stdio --scope user apple-maps -- uvx apple-maps-mcp

--scope user makes the server available in every project. To share it with one repository through its .mcp.json instead, use --scope project.

Transport

stdio is the default and recommended transport. Set APPLE_MAPS_MCP_TRANSPORT=streamable-http (with optional APPLE_MAPS_MCP_HOST and APPLE_MAPS_MCP_PORT) to serve Streamable HTTP instead.

Prompting Notes

  • tools/list returns the full Maps tool surface. Context-constrained clients can use search_tools first, then get_tool_info for the Maps tool they need.
  • Use this server when travel, routing, or place lookup affects a Calendar, Reminders, Messages, or Mail action.
  • Confirm origin, destination, and transport mode before writing a time-sensitive plan.
  • If helper compilation fails, install Xcode command line tools and retry.

Health And Recovery

  • maps_health
  • maps_permission_guide

Launch Checklist

  • Add uvx apple-maps-mcp (or a clone's AppleMaps-MCP/start.sh) to your MCP client
  • Reload or reconnect the client so the Maps tool surface is loaded into context
  • Call maps_health first
  • If the local helper or routing surface is blocked, call maps_permission_guide
  • Run maps_search_places once to confirm the local Swift helper compiles

Source: AppleMaps-MCP/README.md at commit 9aeaa81

Tools

10

maps_health

Maps Health

Report the active Apple Maps MCP configuration.

Takes no parameters.

maps_permission_guide

Maps Permission Guide

Explain Apple Maps MCP local helper requirements on macOS.

Takes no parameters.

maps_search_places

Search Places

Search Apple Maps for matching places.

Parameterslimitqueryrequired

maps_get_directions

Get Directions

Get Apple Maps route details between an origin and destination.

Parametersoriginrequiredtransportdestinationrequired

maps_open_directions_in_maps

Open Directions In Maps

Open directions in the Apple Maps app.

Parametersorigintransportdestinationrequired

maps_list_prompts

Maps List Prompts

Fallback prompt discovery tool for tool-only MCP clients.

Takes no parameters.

maps_get_prompt

Maps Get Prompt

Fallback prompt rendering tool for tool-only MCP clients.

Parametersnamerequiredarguments_json

search_tools

Search Tools

Search this server's tool catalog by keyword, alias, or domain tag.

Parametersmodelimitqueryrequireddomain_tags

get_tool_info

Get Tool Info

Load the full schema, examples, and metadata for one tool from this server.

Parametersnamerequiredinclude_schemainclude_examples

Version history

8
  1. v1.1.6LatestNov 6, 2026
  2. v1.1.4Oct 29, 2026
  3. v1.1.3Oct 22, 2026
  4. v1.1.2Oct 14, 2026
  5. v1.1.1Oct 13, 2026
  6. v1.1.0Oct 10, 2026
  7. v1.0.5Sep 26, 2026
  8. v1.0.4Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts