iMCP: MCP service tool for connecting macOS data to big models

General Introduction

iMCP is an application designed for macOS users to seamlessly connect your everyday data (e.g. messages, contacts, calendars, etc.) with AI tools via Model Context Protocol (MCP). It was developed by the loopwork-ai team and supports the integration with the Claude Clients such as Desktop work together to give users access to personalized information directly from AI, such as checking the weather for their current location or managing their schedules. iMCP does not store user data and relies on macOS sandboxing permissions to ensure privacy and security. Currently, it requires macOS 15.3 or later, and is ideal for tech enthusiasts or developers who want to use local data with AI.

Function List

• calendar management: View and create calendar events with support for setting repeat rules, reminders and busy status.
• Contact Enquiry: Access personal information or search for contacts by name, phone, or email.
• location service: Get the current location data and convert the address to geographic coordinates.
• Message History: Retrieve a record of messages with a specific contact with a customizable time range.
• Reminders: View and add reminders with support for setting deadlines, priorities and notifications.
• Weather Enquiry: Provides real-time weather information for any location, including temperature, wind speed, and more.
• JSON-LD Output: Tool results are returned in a standardized JSON-LD format for easy processing by AI.

Using Help

Installation process

1. Download iMCP
   Visit the GitHub page to download the latest version of the iMCP application. Make sure you have macOS version 15.3 or higher. Once downloaded, drag the file into your Applications folder.
2. first time you turn
   Double-click iMCP.app to launch the program. When you run it for the first time, you may be prompted "Cannot open because the developer is not verified". Right-click on the file and select "Open", then confirm "Open" in the pop-up window to bypass the restriction. Once launched, you will see the iMCP icon in the menu bar.
3. Connect with Claude Desktop
   • If you don't have Claude Desktop, first download and install it from its official website.
   • Open Claude Desktop and press ⌘ + , Go to "Settings", select the "Developer" tab and click "Edit Config".
   • In the iMCP interface, click "Configure Claude Desktop", the program will automatically set the imcp-server The configuration is written to the ~/Library/Application Support/Claude/claude_desktop_config.json Documentation.
   • Or configure it manually: click on "Copy server". command to clipboard", paste the command into the configuration file in the following format:

     {
     "mcpServers": {
     "iMCP": {
     "command":"{pasted command}"
     }
     }
     }
     

   • After saving the file, close and restart Claude Desktop. a connection confirmation window will pop up, which may appear twice, click "Approve".

Functional operation flow

activation service

• Click the iMCP icon in the menu bar to bring up the list of services. Initially, all service icons are grayed out, indicating that they are not activated.
• Click on a service icon (e.g. Calendar) and macOS will pop up a permission request window, e.g. "'iMCP' would like to have full access to your calendar". Select "Allow full access".
• After activation, the icons become colored (calendar in red, messages in green, etc.). Repeat this step to activate other services.
• special note: To activate the Messages service, you need to open it manually via the file selector. ~/Library/Messages/chat.db file to authorize iMCP access.

Using Calendar Management

• In the Claude Desktop chat box type, "What's on the agenda today?"
• Claude will call iMCP's Calendar tool and return a list of the day's events. You can go ahead and type, "Add a meeting for tomorrow at 3 p.m. to remind me to be 15 minutes early."
• The iMCP creates a new event and sets a reminder, returning an acknowledgement when it is complete.

Inquiry Contact

• Enter: "Who in my contacts has a phone number of 123-456-7890?"
• iMCP searches and returns matching contact names and other information. Searching by name or email is supported, e.g., "Find John Doe's email."

Get Location and Weather

• Enter: "Where am I now? What's the weather like there?"
• iMCP first calls the location service to get the coordinates, and then returns the current temperature, wind speed and other data through the weather tool. For example: "You are in San Francisco, the weather is sunny and the temperature is 20°C."

View Message History

• Enter: "What did Alice and I say last week?"
• iMCP will retrieve chat.db It returns the content of the message in a specified time range, based on the conversation with Alice in the dialog. The results are presented in JSON-LD format, which is easy to read.

Setting reminders

• Enter, "Remind me to buy milk tomorrow at 9 a.m. High priority."
• iMCP creates reminders with deadlines and priority settings and confirms in Claude: "Reminder added."

Operating Tips

• View available tools: After restarting Claude Desktop, "🔨12" is displayed in the lower right corner of the chat box, click on it to see the list of tools provided by iMCP.
• Privacy Controls: Manual authorization is required each time a service is activated, and unactivated services cannot access data.
• Technical details: iMCP automatically discovers services on the local network through Bonjour.imcp-server Use standard inputs and outputs to communicate with the client.

With these steps, you can easily get started with iMCP and combine macOS data with AI to improve your daily efficiency.