$git clone https://github.com/mattt/iMCPiMCP 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].
| 1 | <picture> |
| 2 | <source media="(prefers-color-scheme: dark)" srcset="Assets/hero-dark.svg"> |
| 3 | <source media="(prefers-color-scheme: light)" srcset="Assets/hero-light.svg"> |
| 4 | <img alt="iMCP"> |
| 5 | </picture> |
| 6 | |
| 7 | iMCP is a macOS app for connecting your digital life with AI. |
| 8 | It works with [Claude Desktop][claude-app] |
| 9 | and a [growing list of clients][mcp-clients] that support the |
| 10 | [Model Context Protocol (MCP)][mcp]. |
| 11 | |
| 12 | ## Capabilities |
| 13 | |
| 14 | <table> |
| 15 | <tr> |
| 16 | <th> |
| 17 | <img src="Assets/calendar.svg" width="48" height="48" alt="" role="presentation"/> |
| 18 | </th> |
| 19 | <td><strong>Calendar</strong></td> |
| 20 | <td>View and manage calendar events, including creating new events with customizable settings like recurrence, alarms, and availability status.</td> |
| 21 | </tr> |
| 22 | <tr> |
| 23 | <th> |
| 24 | <img src="Assets/contacts.svg" width="48" height="48" alt="" role="presentation"/> |
| 25 | </th> |
| 26 | <td><strong>Contacts</strong></td> |
| 27 | <td>Access contact information about yourself and search your contacts by name, phone number, or email address.</td> |
| 28 | </tr> |
| 29 | <tr> |
| 30 | <th> |
| 31 | <img src="Assets/location.svg" width="48" height="48" alt="" role="presentation"/> |
| 32 | </th> |
| 33 | <td><strong>Location</strong></td> |
| 34 | <td>Access current location data and convert between addresses and geographic coordinates.</td> |
| 35 | </tr> |
| 36 | <tr> |
| 37 | <th> |
| 38 | <img src="Assets/maps.svg" width="48" height="48" alt="" role="presentation"/> |
| 39 | </th> |
| 40 | <td><strong>Maps</strong></td> |
| 41 | <td>Provides location services including place search, directions, points of interest lookup, travel time estimation, and static map image generation.</td> |
| 42 | </tr> |
| 43 | <tr> |
| 44 | <th> |
| 45 | <img src="Assets/messages.svg" width="48" height="48" alt="" role="presentation"/> |
| 46 | </th> |
| 47 | <td><strong>Messages</strong></td> |
| 48 | <td>Access message history with specific participants within customizable date ranges.</td> |
| 49 | </tr> |
| 50 | <tr> |
| 51 | <th> |
| 52 | <img src="Assets/reminders.svg" width="48" height="48" alt="" role="presentation"/> |
| 53 | </th> |
| 54 | <td><strong>Reminders</strong></td> |
| 55 | <td>View and create reminders with customizable due dates, priorities, and alerts across different reminder lists.</td> |
| 56 | </tr> |
| 57 | <tr> |
| 58 | <th> |
| 59 | <img src="Assets/weather.svg" width="48" height="48" alt="" role="presentation"/> |
| 60 | </th> |
| 61 | <td><strong>Weather</strong></td> |
| 62 | <td>Access current weather conditions including temperature, wind speed, and weather conditions for any location.</td> |
| 63 | </tr> |
| 64 | </table> |
| 65 | |
| 66 | ## Getting Started |
| 67 | |
| 68 | ### Download and open the app |
| 69 | |
| 70 | First, [download the iMCP app](https://iMCP.app/download) |
| 71 | (requires macOS 15.3 or later). |
| 72 | |
| 73 | Or, if you have [Homebrew](https://brew.sh) installed, |
| 74 | you can run the following command: |
| 75 | |
| 76 | ```console |
| 77 | brew install --cask mattt/tap/iMCP |
| 78 | ``` |
| 79 | |
| 80 | <img align="right" width="344" src="/Assets/imcp-screenshot-first-launch.png" alt="Screenshot of iMCP on first launch" /> |
| 81 | |
| 82 | When you open the app, |
| 83 | you'll see a |
| 84 | <img style="display: inline" width="20" height="16" src="/Assets/icon.svg" /> |
| 85 | icon in your menu bar. |
| 86 | |
| 87 | Clicking on this icon reveals the iMCP menu, |
| 88 | which displays all available services. |
| 89 | Initially, all services will appear in gray, |
| 90 | indicating they're inactive. |
| 91 | |
| 92 | The blue toggle switch at the top indicates that the MCP server is running |
| 93 | and ready to connect with MCP-compatible clients. |
| 94 | |
| 95 | <br clear="all"> |
| 96 | |
| 97 | <img align="right" width="372" src="/Assets/imcp-screenshot-grant-permission.png" alt="Screenshot of macOS permission dialog" /> |
| 98 | |
| 99 | ### Activate services |
| 100 | |
| 101 | To activate a service, click on its icon. |
| 102 | The system will prompt you with a permission dialog. |
| 103 | For example, when activating Calendar access, you'll see a dialog asking `"iMCP" Would Like Full Access to Your Calendar`. |
| 104 | Click <kbd>Allow Full Access</kbd> to continue. |
| 105 | |
| 106 | > [!IMPORTANT] |
| 107 | > iMCP **does not** collect or store any of your data. |
| 108 | > Clients like Claude Desktop _do_ send |
| 109 | > your data off device as part of tool calls. |
| 110 | |
| 111 | <br clear="all"> |
| 112 | |
| 113 | <img align="right" width="344" src="/Assets/imcp-screenshot-all-services-active.png" alt="Screenshot of iMCP with a |