iMCP

<picture> <source media="(prefers-color-scheme: dark)" srcset="Assets/hero-dark.svg"> <source media="(prefers-color-scheme: light)" srcset="Assets/hero-light.svg"> <img alt="iMCP"> </picture> iMCP is a macOS app for connecting your digital life with AI. It works with [Claude Desktop][claude-app] and a [growing list of clients][mcp-clients] that support the [Model Context Protocol (MCP)][mcp]. ## Capabilities <table> <tr> <th> <img src="Assets/calendar.svg" width="48" height="48" alt="" role="presentation"/> </th> <td><strong>Calendar</strong></td> <td>View and manage calendar events, including creating new events with customizable settings like recurrence, alarms, and availability status.</td> </tr> <tr> <th> <img src="Assets/contacts.svg" width="48" height="48" alt="" role="presentation"/> </th> <td><strong>Contacts</strong></td> <td>Access contact information about yourself and search your contacts by name, phone number, or email address.</td> </tr> <tr> <th> <img src="Assets/location.svg" width="48" height="48" alt="" role="presentation"/> </th> <td><strong>Location</strong></td> <td>Access current location data and convert between addresses and geographic coordinates.</td> </tr> <tr> <th> <img src="Assets/maps.svg" width="48" height="48" alt="" role="presentation"/> </th> <td><strong>Maps</strong></td> <td>Provides location services including place search, directions, points of interest lookup, travel time estimation, and static map image generation.</td> </tr> <tr> <th> <img src="Assets/messages.svg" width="48" height="48" alt="" role="presentation"/> </th> <td><strong>Messages</strong></td> <td>Access message history with specific participants within customizable date ranges.</td> </tr> <tr> <th> <img src="Assets/reminders.svg" width="48" height="48" alt="" role="presentation"/> </th> <td><strong>Reminders</strong></td> <td>View and create reminders with customizable due dates, priorities, and alerts across different reminder lists.</td> </tr> <tr> <th> <img src="Assets/weather.svg" width="48" height="48" alt="" role="presentation"/> </th> <td><strong>Weather</strong></td> <td>Access current weather conditions including temperature, wind speed, and weather conditions for any location.</td> </tr> </table> ## Getting Started ### Download and open the app First, [download the iMCP app](https://iMCP.app/download) (requires macOS 15.3 or later). Or, if you have [Homebrew](https://brew.sh) installed, you can run the following command: ```console brew install --cask mattt/tap/iMCP ``` <img align="right" width="344" src="/Assets/imcp-screenshot-first-launch.png" alt="Screenshot of iMCP on first launch" /> When you open the app, you'll see a <img style="display: inline" width="20" height="16" src="/Assets/icon.svg" /> icon in your menu bar. Clicking on this icon reveals the iMCP menu, which displays all available services. Initially, all services will appear in gray, indicating they're inactive. The blue toggle switch at the top indicates that the MCP server is running and ready to connect with MCP-compatible clients. <br clear="all"> <img align="right" width="372" src="/Assets/imcp-screenshot-grant-permission.png" alt="Screenshot of macOS permission dialog" /> ### Activate services To activate a service, click on its icon. The system will prompt you with a permission dialog. For example, when activating Calendar access, you'll see a dialog asking `"iMCP" Would Like Full Access to Your Calendar`. Click <kbd>Allow Full Access</kbd> to continue. > [!IMPORTANT] > iMCP **does not** collect or store any of your data. > Clients like Claude Desktop _do_ send > your data off device as part of tool calls. <br clear="all"> <img align="right" width="344" src="/Assets/imcp-screenshot-all-services-active.png" alt="Screenshot of iMCP with all services enabled" /> Once activated, each service icons goes from gray to their distinctive colors — red for Calendar, green for Messages, blue for Location, and so on. Repeat this process for all of the capabilities you'd like to enable. These permissions follow Apple's standard security model, giving you complete control over what information iMCP can access. <!-- <br clear="all"> --> <!-- <img align="right" width="344" src="/Assets/imcp-screenshot-configure-claude-desktop.png" /> --> <br clear="all"> ### Connect to Claude Desktop If you don't have Claude Desktop installed, you can [download it here](https://claude.ai/download). Open Claude Desktop and go to "Settings... (<kbd>⌘</kbd><kbd>,</kbd>)". Click on "Developer" in the sidebar of the Settings pane, and then click on "Edit Config". This will create a configuration file at `~/Library/Application Support/Claude/claude_desktop_config.json`. <br/> To connect iMCP to Claude Desktop, click <img style="display: inline" w