IMCP

What is iMCP?

iMCP is a macOS app that connects your personal data—calendar, contacts, messages, location, reminders, weather, and maps—to AI assistants via the Model Context Protocol (MCP). It works with MCP-compatible clients like Claude Desktop, Claude Code, Cursor, and Amp.

How to use iMCP?

Download the iMCP app (macOS 15.3 or later) from iMCP.app or install via Homebrew with brew install --cask mattt/tap/iMCP. Open the app, click the menu bar icon, and enable each service by granting the required macOS system permissions. Then connect to your MCP client (e.g., Claude Desktop) using the app’s “Configure” option or manual JSON configuration. Quit and reopen the client, approve the connection, and start using the tools.

Key features of iMCP

• Calendar: view and create events with recurrence, alarms, and availability.
• Contacts: search contacts by name, phone, or email.
• Location: access current location and convert addresses to coordinates.
• Maps: place search, directions, points of interest, travel time, static maps.
• Messages: query message history with date filters.
• Reminders: view and create reminders with due dates, priorities, and alerts.
• Weather: get current conditions for any location.

Use cases of iMCP

• Ask Claude “What’s on my calendar today?” and get events without manual sharing.
• Have an AI assistant find a contact’s phone number from your address book.
• Request driving directions or weather conditions for your current location.
• Create a new reminder or calendar event by voice or text via an MCP client.
• Search past iMessages for a specific conversation within a date range.

FAQ from iMCP

Does iMCP collect or store my data?

No. iMCP does not collect or store any of your data. However, clients like Claude Desktop may send your data off-device as part of tool calls.

What are the system requirements?

iMCP requires macOS 15.3 or later. It is a macOS app only.

How does iMCP access my iMessages?

Apple does not provide a public API for Messages. iMCP uses a file picker (NSOpenPanel) to grant sandbox access to the iMessage SQLite database at ~/Library/Messages/chat.db. It also reads the typedstream format via the open-source Madrid package.

What transport protocol does iMCP use?

The bundled imcp-server CLI uses standard input/output (stdio transport) for MCP communication. The app and CLI communicate locally over Bonjour.

Can I debug iMCP’s interactions?

Yes. Use the MCP Inspector (npx @modelcontextprotocol/inspector) after copying the server command from the iMCP menu. Alternatively, use the Companion app.