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 project apple-maps -- uvx apple-maps-mcp

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

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for JonathanRReed from gravatar.com JonathanRReed

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

mcp model-context-protocol macos apple ai-agent automation

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apple_maps_mcp-1.0.0.tar.gz (13.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

apple_maps_mcp-1.0.0-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

File details

Details for the file apple_maps_mcp-1.0.0.tar.gz.

File metadata

  • Download URL: apple_maps_mcp-1.0.0.tar.gz
  • Upload date:
  • Size: 13.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for apple_maps_mcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 1f92729be2aa709cbd6e24a82e0109c380ebc20345042ad13e50c5787347b311
MD5 b12e70481b53c51713cd85f6bcd94899
BLAKE2b-256 9d4fd2d5841906403eba134e314bdb87923368eed10fe8139e9339db8a9253cb

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_maps_mcp-1.0.0.tar.gz:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file apple_maps_mcp-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: apple_maps_mcp-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 12.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for apple_maps_mcp-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b5ae2128be0d7c142c30cda6a9d24194138c16c7a5d571cb13c6b6aa7f6c845d
MD5 2ad6900b3339f418a711944e4b78c4a3
BLAKE2b-256 4eaada5529bd3f6110d4b9c12139dec85317b7df4d4555d634a9d42f84fd87b0

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_maps_mcp-1.0.0-py3-none-any.whl:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page