📌Overview

Purpose: iMCP is designed to seamlessly integrate your digital life with AI, leveraging the capabilities of macOS while interacting with various clients that support the Model Context Protocol (MCP).

Overview: iMCP is a powerful macOS application that facilitates connection to multiple digital services, enhancing your interaction with Claude Desktop and other compatible clients. It provides an intuitive interface for managing permissions and utilizes existing macOS features to enable AI-driven personalized responses and data handling.

Key Features:

Calendar Management: View, create, and manage events with customizable settings such as recurrence and alarms, allowing for effective scheduling.
Contact Access: Easily retrieve and search contact information, enabling efficient communication management without manual data input.
Location Services: Access and convert location data, providing geographical context for various applications and interaction.
Message History Access: View past messages with specific contacts over set date ranges, allowing you to track conversations and retrieve past information conveniently.
Reminders Creation: Create and manage reminders with customizable due dates and priorities, helping users stay organized.
Weather Updates: Retrieve current weather conditions based on location, offering users timely weather information contextualized within their conversations.

iMCP

iMCP is a macOS app for connecting your digital life with AI, compatible with Claude Desktop and a list of clients that support the Model Context Protocol (MCP).

Capabilities

Calendar: View and manage calendar events, including creating new events with customizable settings.
Contacts: Access contact information and search your contacts by name, phone number, or email address.
Location: Access current location data and convert between addresses and geographic coordinates.
Messages: Access message history with specific participants within customizable date ranges.
Reminders: View and create reminders with customizable due dates, priorities, and alerts.
Weather: Access current weather conditions for any location.

Tip: Have a suggestion for a new capability? Reach out to us at imcp@loopwork.com.

Getting Started

Download and Open the App

First, download the iMCP app (requires macOS 15.3 or later).

When you open the app, you'll see an icon in your menu bar. Clicking on this icon reveals the iMCP menu, displaying all available services. Initially, all services appear inactive.

Activate Services

To activate a service, click on its icon. The system will prompt you with a permission dialog. Click Allow Full Access to continue.

Important: iMCP does not collect or store any of your data; clients like Claude Desktop may send your data off device.

Once activated, each service icon will change color, indicating they are active.

Connect to Claude Desktop

If you don't have Claude Desktop, you can download it here.

Open Claude Desktop, go to "Settings...", and click on "Developer" in the sidebar. Create a configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json.

To connect iMCP to Claude Desktop, select "Configure Claude Desktop". This updates the MCP server configuration to use the bundled imcp-server.

You can also configure Claude Desktop manually

You can copy the server command to clipboard and enter it in claude_desktop_config.json.

Call iMCP Tools from Claude Desktop

After connecting, quit and reopen Claude Desktop. Approve the connection when prompted.

You can now ask Claude questions that require access to your personal data, such as "How's the weather where I am?" Claude will provide accurate, personalized responses using the enabled tools.

Technical Details

App & CLI

iMCP is a macOS app that includes a command-line executable, imcp-server.

iMCP.app provides a user interface for configuring services and accessing macOS system permissions.
imcp-server serves as the MCP server that uses standard input/output for communication.

JSON-LD for Tool Results

The tools provided by iMCP return results as JSON-LD documents, formatted for structured data representation.

Acknowledgments

Justin Spahr-Summers, David Soria Parra, and Ashwin Bhat for their work on MCP.
Christopher Sardegna for reverse-engineering the typedstream format.

License

This project is licensed under the Apache License, Version 2.0.

Legal

iMessage® is a registered trademark of Apple Inc. This project is not affiliated with, endorsed, or sponsored by Apple Inc.