Skip to main content
Glama

Apple Find My MCP Server

by batteryshark

Apple Find My MCP Server

An MCP (Model Context Protocol) server that provides access to Apple's Find My network for device tracking and management.

Overview

This server allows you to interact with your Apple devices through the Find My network, providing location tracking, battery status, and device information via MCP-compatible tools.

Features

Device Management

  • List Devices: Retrieve all devices associated with your Apple account
  • Device Info: Get detailed information including location, battery level, and status for specific devices
  • Caching: 5-minute cache for improved performance and reduced API calls

Administration

  • Cache Management: Clear caches, refresh data, or reset authentication
  • Credential Management: Securely store and manage Apple ID credentials
  • Authentication: Interactive Apple ID authentication with secure credential storage

Tools

Device Tools

  • list_devices() - List all Find My devices with basic information
  • get_device_info(discovery_id) - Get comprehensive details for a specific device

Admin Tools

  • clear_stored_credentials() - Remove stored Apple ID and password from secure storage
  • refresh_cache() - Clear data cache and force fresh data retrieval

Installation

Prerequisites

  • Python 3.11+
  • Apple ID with Find My enabled

Install Dependencies

pip install -r requirements.txt # or if using uv: uv sync

Build

uv build

Usage

Running the Server

# Using uv uv run server # Or directly python server.py

Configuration

  • HOST: Server host (default: 127.0.0.1)
  • PORT: Server port (optional, defaults to auto-assigned)

MCP Configuration Example

"findmy-server": { "type": "stdio", "command": "uv", "args": [ "--directory", "/path/to/findmy-server", "run", "server" ] },

Authentication

The server uses interactive authentication for your Apple ID. On first use:

  1. Provide your Apple ID email when prompted
  2. Enter your password (stored securely using keyring)
  3. Complete 2FA if required

Credentials are stored securely and reused for subsequent requests.

Dependencies

  • fastmcp>=2.11.3 - MCP server framework
  • pyicloud>=2.0.2 - Apple iCloud/Find My API client
  • keyring>=25.6.0 - Secure credential storage

Security

  • Credentials are stored securely using system keyring
  • Authentication state is cached per session
  • Data is cached for 5 minutes to minimize API calls
  • No sensitive data is logged or stored permanently

License

This project is provided as-is for personal use with Apple's Find My service.

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables interaction with Apple's Find My network to track devices, check battery status, and manage device information. Provides secure authentication and caching for efficient access to your Apple devices' location and status data.

  1. Overview
    1. Features
      1. Device Management
      2. Administration
    2. Tools
      1. Device Tools
      2. Admin Tools
    3. Installation
      1. Prerequisites
      2. Install Dependencies
      3. Build
    4. Usage
      1. Running the Server
      2. Configuration
      3. MCP Configuration Example
    5. Authentication
      1. Dependencies
        1. Security
          1. License

            Related MCP Servers

            • A
              security
              F
              license
              A
              quality
              A collection of tools that enable AI assistants to interact with Apple applications and services including Contacts, Notes, Messages, Mail, Reminders, Calendar, Maps, and Web Search through the Model Context Protocol.
              Last updated -
              8
              1
              • Apple
            • A
              security
              A
              license
              A
              quality
              Provides access to satellite tracking data from N2YO, allowing users to query satellite positions, predict passes, and access TLE data through natural language requests.
              Last updated -
              13
              MIT License
            • A
              security
              A
              license
              A
              quality
              Provides advanced system monitoring and file search capabilities for macOS, allowing users to track performance metrics and perform enhanced file searches with content analysis and tagging features.
              Last updated -
              2
              302
              12
              MIT License
              • Apple
            • A
              security
              A
              license
              A
              quality
              Provides seamless access to TomTom's location services including search, routing, traffic and static maps data, enabling easy integration of precise geolocation data into AI workflows and development environments.
              Last updated -
              10
              59
              26
              Apache 2.0

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/batteryshark/mcp-findmy'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server