mcpField
A
Apple Maps

Apple Maps

Local
github.comMaps & Travel32Updated 2d ago
RepositoryVisit website

About Apple Maps

Apple Maps is a local MCP server for macOS that searches places, estimates routes, and creates map links. It is intended for clients that need location and routing details for travel-related tasks.

Key features

  1. 01Search for places
  2. 02Estimate route distance and travel time
  3. 03Create Apple Maps links
  4. 04Open directions in Apple Maps
  5. 05Provide a status resource and route-planning prompt
  6. 06Offer tool discovery and health checks

Use cases

  1. 01Find a destination and nearby places
  2. 02Compare route distance and travel time
  3. 03Create an Apple Maps link for a trip plan

MCP support

It exposes place search, route estimates, map links, and directions actions to MCP clients, along with a status resource and route-planning prompt. It supports stdio and can also be configured for Streamable HTTP.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository
Packages
pypiapple-maps-mcp1.1.4
mcpbapple-maps-1.1.4.mcpb1.1.4

Tools

10

Saved tool list · updated 1d ago

This tool takes no parameters.

Details

From the project 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:

uvx apple-maps-mcp

No clone, no venv management.

From a clone 
git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv 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

{
  "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:

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.