IM
Developer Tools

IMCP macOS MCP Server for iMessage and Reminders

Sync iMessage, Reminders and Apple services with an easy-to-run MCP server on macOS to access, backup and manage messages and tasks.

View on GitHub
Quick Install
npx -y @loopwork-ai/iMCP

Overview

iMCP is a macOS menu‑bar app that exposes local Apple data and services (iMessage, Reminders, Calendar, Contacts, Location, Maps, Weather) over the Model Context Protocol (MCP). Running an MCP server on your Mac lets MCP‑aware clients (for example, Claude Desktop and other MCP clients) call local tools to read, create and manage messages, events, reminders and location data. This is useful for backups, automated task management, agent workflows, and context‑aware AI assistant interactions that need access to on‑device data.

The app acts as a bridge: it requests standard macOS permissions for the services you enable, surfaces those services as MCP tools, and runs a local server binary that MCP clients can invoke. iMCP itself does not upload or store your data; however, MCP clients may send tool results to cloud services, so review client behavior and privacy settings.

Repository and source: https://github.com/loopwork-ai/iMCP

Features

  • Exposes Apple services as MCP tools: Calendar, Contacts, Location, Maps, Messages, Reminders, Weather.
  • Menu‑bar UI to toggle services on/off and manage permissions.
  • Runs a local MCP server binary bundled with the app.
  • Integrates with MCP clients such as Claude Desktop via a simple configuration step.
  • Fine‑grained macOS permission prompts per service; nothing is enabled until you allow it.
  • Read and write operations for events, reminders and messages (subject to macOS APIs and permissions).
  • Static map images, place search, routing and travel time estimates via the Maps tool.

Installation / Configuration

Requirements: macOS 15.3 or later.

Install the app (two ways):

  • Download installer:
# open download page in browser
open "https://iMCP.app/download"
  • Homebrew (cask):
brew install --cask mattt/tap/iMCP

After installation:

  1. Launch iMCP. A small icon appears in the menu bar.
  2. Toggle the MCP server switch to run the server.
  3. Click any service icon to enable it — macOS will prompt for permission (Calendar, Messages, Contacts, Location, etc.). Grant only the services you want the server to expose.

Configure an MCP client (example: Claude Desktop)

  1. In Claude Desktop, open Settings → Developer → Edit Config to create or open: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. iMCP can auto‑configure Claude Desktop via the app UI. Alternatively, add a server entry manually. Example JSON:
{
  "mcpServers": {
    "iMCP": {
      "command": "/Applications/iMCP.app/Contents/MacOS/imcp-server --port 12345 --allow-unauthenticated"
    }
  }
}

Replace the command with the actual server command shown in iMCP (use the app UI to copy the precise command). Restart the client; grant the client permission when prompted to allow the connection.

Note: command arguments and exact executable path may vary by release. Use the command provided by the iMCP app for the most compatible configuration.

Available Resources

The server exposes a set of MCP tools representing local data and services. Typical resources and capabilities:

  • Calendar: list events, create/update events, set recurrence, alarms and availability.
  • Contacts: lookup by name, phone, email; access self/contact details.
  • Messages: query iMessage/SMS threads by participant and date range; read message history.
  • Reminders: list/create/modify reminders across lists; set due dates, priorities, alerts.
  • Location: current device coordinates and reverse/geocoding.
  • Maps: place search, directions, points of interest, travel time, and static map tiles.
  • Weather: current conditions and basic forecasts by location.

Use the MCP client’s tool invocation mechanism to call these tools; responses follow MCP tool result formats.

Use Cases

  • Backup iMessage threads: use an MCP client script to query message history for specific participants and save transcripts to a file or a local database.
  • Automated scheduling: ask an LLM in an MCP client to create events based on email/text content. The client calls the Calendar tool to propose or create events with reminders and availability flags.
  • Task automation: convert messages or emails into Reminders or calendar events via an AI agent that calls the Reminders and Calendar tools.
  • Contextual assistance: provide an AI assistant with current location + nearby POIs (Maps) and local weather (Weather) to generate travel recommendations or packing lists.
  • Contact lookup in workflows: an assistant can resolve a contact by name and surface phone/email when composing messages or triggering calls.

Privacy and Security

  • iMCP requests only the macOS permissions you explicitly grant via system dialogs. Services remain inactive until enabled.
  • The iMCP app does not upload or retain your data. However, MCP clients may transmit tool outputs to remote services — check client privacy policies and disable any cloud sync if local-only privacy is required.
  • Use firewall rules or client configuration to restrict which MCP clients can connect to the server.

For more details, source and issue tracker: https://github.com/loopwork-ai/iMCP

Tags:developer-toolsmacosmcp