--- title: "iMCP: Messages, Calendar and Notes from Your Mac to Claude" url: "https://mcpshelf.co/servers/imcp" description: "iMCP is a Mac menu bar app that shares Calendar, Contacts, Messages, Notes, Reminders, Mail, Maps and more with an AI app, one permission at a time." updated: "2026-10-27" site: "MCP Shelf" --- # iMCP > A Mac menu bar app that shares Calendar, Messages, Notes, Reminders and more with your assistant. Source: https://mcpshelf.co/servers/imcp Markdown: https://mcpshelf.co/servers/imcp.md Generated: 2026-10-27T13:19:52.488Z ## Facts - **Name:** iMCP - **Tagline:** A Mac menu bar app that shares Calendar, Messages, Notes, Reminders and more with your assistant. - **Description:** iMCP is a free macOS app by Mattt that turns on an MCP server for your Mac's Calendar, Contacts, Messages, Mail, Notes, Reminders, Maps, Location and Weather, with a permission switch for each. - **Repository:** https://github.com/loopwork-ai/iMCP - **Install:** `claude mcp add imcp -- /Applications/iMCP.app/Contents/MacOS/imcp-server` - **Transport:** stdio (local) - **Auth:** Needs `Services (iMCP menu)` - **Tools exposed:** 56: `calendars_list`, `events_fetch`, `events_create`, `events_delete`, `events_update`, `capture_take_picture`, `capture_record_audio`, `capture_take_screenshot`, `contacts_me`, `contacts_search`, `contacts_list`, `contacts_update`, `contacts_create`, `location_current`, `location_geocode`, `location_reverse-geocode`, `mail_mailboxes_list`, `mail_messages_search`, `mail_messages_read`, `mail_compose`, `maps_search`, `maps_directions`, `maps_explore`, `maps_eta`, `maps_generate`, `messages_fetch`, `messages_attachment_read`, `music_now_playing`, `music_control`, `music_catalog_search`, `notes_folders`, `notes_fetch`, `notes_read`, `phone_calls_fetch`, `phone_call`, `reminders_lists`, `reminders_fetch`, `reminders_create`, `reminders_update`, `reminders_delete`, `reminders_lists_create`, `reminders_lists_rename`, `reminders_lists_delete`, `shortcuts_list`, `shortcuts_run`, `utilities_beep`, `voice_memos_fetch`, `voice_memo_transcript_fetch`, `voice_memo_audio_fetch`, `voicemails_fetch`, `voicemail_transcript_fetch`, `voicemail_audio_fetch`, `weather_current`, `weather_daily`, `weather_hourly`, `weather_minute` - **Category:** Knowledge and work apps (https://mcpshelf.co/categories/knowledge-and-work) - **Stats:** 1.9K GitHub stars, last commit 27 Oct 2026, 0 upvotes on MCP Shelf - **Install check:** Needs your setup first - **Listed:** 2026-10-27 - **Page updated:** 2026-10-27 ## Full description ### What is iMCP? **iMCP is a free macOS app by Mattt that turns on an MCP server for your Mac's Calendar, Contacts, Messages, Mail, Notes, Reminders, Maps, Location and Weather, with a permission switch for each.** iMCP, made by Mattt, is a native macOS app that sits in the menu bar and exposes your Mac's own data to AI apps: calendars, contacts, Messages, Mail, Notes, Reminders, Maps, location, weather, Music, the camera and screenshots, call history, voicemail, Voice Memos and Shortcuts. It bundles the server, so there is nothing to install from npm or PyPI. Every service starts switched off apart from Maps, and turning one on triggers the normal macOS permission prompt for it. The first time a client connects, iMCP asks you to approve it. The app stores none of your data itself, but remember that whatever a tool returns goes to the AI app you connected. | | | | --- | --- | | Made by | Mattt | | GitHub | https://github.com/loopwork-ai/iMCP | | Licence | MIT | | GitHub stars | 1.9K | | Last commit | 27 Oct 2026 | | Tools | 56 | | Runs on | Your computer | | Install check | Needs your setup first | | Category | [Knowledge and work apps](https://mcpshelf.co/categories/knowledge-and-work) | | Setup checked | 27 Oct 2026 | | Page updated | 27 Oct 2026 | **Our check:** It needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 27 Oct 2026 we read its tools from the source code instead of running this config. The shared database gave a command for the MCP Inspector, not this server. The server is the imcp-server program inside the app. #### MCP Shelf take > iMCP needs something our Linux test machine does not have (an account, an app or a service), so on 27 Oct 2026 we read its source and counted 56 tools. 41 of the 56 only read; the other 15 can change things. Other directories point at a package with the same name that belongs to someone else; the config on this page installs the real one. It sits 12th of 16 in its category on our shelf by GitHub stars (1.9K). — MCP Shelf tests (numbers from our own runs), tested on 27 Oct 2026 ### What tools does iMCP have? We listed 56 tools on 27 Oct 2026. 41 only read; the rest can change things or run commands. | Tool | Kind | What it is for | | --- | --- | --- | | `calendars_list` | reads | Lists your calendars. | | `events_fetch` | reads | Finds calendar events by date range, calendar, text and status. | | `events_create` | changes | Adds an event, with location, notes, alarms and repeats if needed. | | `events_delete` | changes | Deletes an event. | | `events_update` | changes | Changes an event, or one occurrence of a repeating event. | | `capture_take_picture` | reads | Takes a photo with the Mac's camera. | | `capture_record_audio` | reads | Records audio from the microphone. | | `capture_take_screenshot` | reads | Takes a screenshot of the screen, a window or an app. | | `contacts_me` | reads | Returns your own contact card. | | `contacts_search` | reads | Finds contacts by name, phone or email. | | `contacts_list` | reads | Lists all contacts, a page at a time. | | `contacts_update` | changes | Changes a contact's details. | | `contacts_create` | changes | Adds a contact. | | `location_current` | reads | Returns where your Mac is now. | | `location_geocode` | reads | Turns an address into coordinates. | | `location_reverse-geocode` | reads | Turns coordinates into an address. | | `mail_mailboxes_list` | reads | Lists the mailboxes in Apple Mail. | | `mail_messages_search` | reads | Searches Mail by sender, subject, mailbox and date. | | `mail_messages_read` | reads | Reads one email. | | `mail_compose` | changes | Opens a new email in your mail app for you to review and send. It does not send anything. | | `maps_search` | reads | Searches Apple Maps for places and addresses. | | `maps_directions` | reads | Gets driving or walking directions. | | `maps_explore` | reads | Finds places of a kind near a point, such as cafes. | | `maps_eta` | reads | Estimates travel time between two points. | | `maps_generate` | reads | Makes a map image of an area. | | `messages_fetch` | reads | Reads iMessages and texts by person, chat, date or text. | | `messages_attachment_read` | reads | Opens an attachment from a message. | | `music_now_playing` | reads | Shows what is playing in Music. | | `music_control` | changes | Plays, pauses, skips or seeks in Music. | | `music_catalog_search` | reads | Searches the Apple Music catalogue. | | `notes_folders` | reads | Lists your Notes folders. | | `notes_fetch` | reads | Finds notes by text, folder or date. | | `notes_read` | reads | Reads a note as Markdown. Locked notes cannot be read. | | `phone_calls_fetch` | reads | Reads call history synced from your iPhone. | | `phone_call` | changes | Starts a phone call through your iPhone. | | `reminders_lists` | reads | Lists your reminder lists. | | `reminders_fetch` | reads | Finds reminders by list, date, text or completion. | | `reminders_create` | changes | Adds a reminder. | | `reminders_update` | changes | Changes or completes a reminder. | | `reminders_delete` | changes | Deletes a reminder. | | `reminders_lists_create` | changes | Creates a reminder list. | | `reminders_lists_rename` | changes | Renames a reminder list. | | `reminders_lists_delete` | changes | Deletes a reminder list and everything in it. | | `shortcuts_list` | reads | Lists your Shortcuts. | | `shortcuts_run` | runs | Runs a shortcut, optionally with text input. | | `utilities_beep` | reads | Plays a system sound. Always available, so you can test a connection. | | `voice_memos_fetch` | reads | Lists Voice Memos recordings. | | `voice_memo_transcript_fetch` | reads | Reads the transcript Voice Memos made of a recording. | | `voice_memo_audio_fetch` | reads | Returns a recording's audio. | | `voicemails_fetch` | reads | Lists voicemails synced to the Mac. | | `voicemail_transcript_fetch` | reads | Reads a voicemail's transcript. | | `voicemail_audio_fetch` | reads | Returns a voicemail's audio. | | `weather_current` | reads | Current weather for a location. | | `weather_daily` | reads | Daily forecast for a location. | | `weather_hourly` | reads | Hourly forecast for a location. | | `weather_minute` | reads | Minute-by-minute forecast for a location. | ### How do I install iMCP? #### What you need first - A Mac with macOS 15.3 or newer - The iMCP app, open while you use it 1. Download iMCP from iMCP.app/download, or run "brew install --cask mattt/tap/iMCP", and open it. 2. Click the menu bar icon and turn on the services you want, allowing each macOS permission as it is asked. 3. Add the config below to your client, or use the Configure option in the iMCP menu for Claude Desktop, then approve the connection when iMCP asks. #### Claude Code Where: Your terminal, in the project folder ```bash claude mcp add imcp -- /Applications/iMCP.app/Contents/MacOS/imcp-server ``` Use Copy server command to clipboard in the iMCP menu if the app lives somewhere other than /Applications. iMCP must be open, and it asks you to approve Claude Code the first time it connects. #### Cursor Where: ~/.cursor/mcp.json, or .cursor/mcp.json in a project ```json { "mcpServers": { "imcp": { "command": "/Applications/iMCP.app/Contents/MacOS/imcp-server", "args": [] } } } ``` #### Claude Desktop Where: claude_desktop_config.json (Settings → Developer → Edit Config) ```json { "mcpServers": { "imcp": { "command": "/Applications/iMCP.app/Contents/MacOS/imcp-server", "args": [] } } } ``` Easier: click the iMCP menu bar icon, choose Configure Claude Desktop, then Set Up. iMCP writes this entry for you and keeps your other servers. Quit and reopen Claude, then approve the connection in iMCP. #### VS Code Where: .vscode/mcp.json in your project ```json { "servers": { "imcp": { "type": "stdio", "command": "/Applications/iMCP.app/Contents/MacOS/imcp-server", "args": [] } } } ``` #### Windsurf Where: ~/.codeium/windsurf/mcp_config.json ```json { "mcpServers": { "imcp": { "command": "/Applications/iMCP.app/Contents/MacOS/imcp-server", "args": [] } } } ``` #### ChatGPT Where: ChatGPT desktop app for Mac → Settings → MCP servers → Add server ``` /Applications/iMCP.app/Contents/MacOS/imcp-server ``` Name it iMCP, choose STDIO as the type and paste the command. The project says these steps are for Codex conversations in the Mac app and have not been tested end to end yet. Checked against the project's own install docs on 27 Oct 2026: https://github.com/loopwork-ai/iMCP#readme ### How do I configure iMCP? | Setting | Kind | Required | What it does | | --- | --- | --- | --- | | `Services (iMCP menu)` | config | yes | Each service, such as Calendar or Messages, is switched on from the menu bar icon and asks for its own macOS permission. Only Maps starts on. | | `Settings > services` | config | no | Turns off single tools inside a service, for example to allow reading reminders but not deleting them. | | `Settings > Clients` | config | no | Lists the AI apps you chose to always trust, and lets you remove them. | ### What can iMCP read and change? **It can read** - Calendars, contacts, Messages, Mail, Notes, Reminders, call history, voicemail and Voice Memos, for the services you switch on - Your location, the camera, the microphone and the screen, when you allow them **It can change** - Calendar events, contacts, reminders and reminder lists - Music playback, and phone calls and shortcuts you ask it to start **Safer setup:** Switch on only the services you need, turn off tools you do not want in Settings, and approve each client rather than always trusting it. A local model keeps the data on your Mac. ### Good for - Asking what is on your calendar and adding events or reminders - Finding an old iMessage, note or contact without digging - Running your Shortcuts from a chat ### iMCP not working? Common fixes **The client cannot connect** iMCP must be open with Enable MCP Server switched on. Then restart the server in your client; the approval prompt can appear behind other windows. **A service will not switch on** You probably denied the macOS prompt. Open System Settings > Privacy & Security, allow iMCP in that category, then click the service again. **New tools do not appear** Tools for a service appear only after it is switched on. Restart the server in your client after turning one on. **The client reports a wrong command** If you moved the app, copy the server command again from the iMCP menu and paste it into your client with no arguments. ### What are the alternatives to iMCP? | Server | What it does | Tools | Runs on | Licence | Stars | | --- | --- | --- | --- | --- | --- | | [iMCP](https://mcpshelf.co/servers/imcp) | A Mac menu bar app that shares Calendar, Messages, Notes, Reminders and more with your assistant. | 56 | Your computer | MIT | 1.9K | | [OpenLore](https://mcpshelf.co/servers/openlore) | One folder of Markdown that every agent on a team can read, with access rules. | 2 | Hosted | Apache-2.0 | 1.7K | | [Minutes](https://mcpshelf.co/servers/minutes) | Records and transcribes meetings on your device, then lets an assistant search them. | 34 | Your computer | MIT | 1.6K | | [Garmin Connect MCP](https://mcpshelf.co/servers/garmin) | Ask an assistant about your Garmin activities, sleep, recovery and training. | 20 | Your computer | MIT | 1.4K | | [Notion](https://mcpshelf.co/servers/notion) | Notion's own server: search, read and update pages and databases. | 24 | Hosted or your computer | MIT | 4.7K | | [MCP Atlassian (Jira and Confluence)](https://mcpshelf.co/servers/atlassian) | Jira issues and Confluence pages, Cloud or self-hosted. | 98 | Your computer | MIT | 6.1K | ### iMCP FAQ #### How do I add iMCP to Claude Desktop? Install iMCP from iMCP.app or with brew install --cask mattt/tap/iMCP, turn on the services you want, then choose Configure Claude Desktop in its menu and click Set Up. Reopen Claude and approve the connection. #### Does iMCP work with ChatGPT? In the ChatGPT desktop app for Mac, through Codex conversations: add a STDIO MCP server with the command iMCP copies to your clipboard. The project notes these steps are not fully tested yet. #### What can iMCP access on my Mac? Calendar, Contacts, Messages, Mail, Notes, Reminders, Maps, Location and Weather, each only after you switch it on and allow the macOS permission. Maps is on at first; the rest start off. #### Does iMCP send my data anywhere? iMCP keeps nothing itself, but whatever a tool returns goes to the AI app you connected, and a cloud model sends it off your Mac. Use a local model through llama.cpp to keep it on device. #### Is iMCP free? Yes. It is an MIT licensed app by Mattt, free to download, with no account. #### Can iMCP send iMessages? No. It can read messages and their attachments, but it has no tool for sending them. It can compose mail and create calendar events, contacts and reminders. #### Does iMCP work on Windows or Linux? No. It is a native macOS app built on Apple's own frameworks, and it needs macOS 15.3 or newer. #### Why can't my app connect to iMCP? iMCP must be running with the Enable MCP Server switch on, and you must approve each app the first time it connects. If the command is wrong, copy it again from the iMCP menu. Full docs on GitHub: https://github.com/loopwork-ai/iMCP ## Notes for agents Fetch these instead of parsing the HTML page: - llms.txt: https://mcpshelf.co/llms.txt - llms-full.txt: https://mcpshelf.co/llms-full.txt - ai.txt: https://mcpshelf.co/ai.txt - Full catalog (.md): https://mcpshelf.co/catalog.md - API spec: https://mcpshelf.co/openapi.json - MCP server: https://mcpshelf.co/mcp - MCP manifest: https://mcpshelf.co/.well-known/mcp.json - Developer docs: https://mcpshelf.co/developers MCP endpoint (Streamable HTTP, no key): https://mcpshelf.co/mcp. REST API: https://mcpshelf.co/api/v1.