|
|
Calendar | View and manage calendar events, including creating new events with customizable settings like recurrence, alarms, and availability status. |
|---|---|---|
|
|
Contacts | Access contact information about yourself and search your contacts by name, phone number, or email address. |
|
|
Home | Find homes, rooms, accessories, scenes, and automations, read and control accessories, and organize rooms and zones. Needs a helper app that you build with your own Apple Developer account. |
|
|
Location | Access current location data and convert between addresses and geographic coordinates. |
|
|
List mailboxes, search messages by sender, subject, mailbox, date, or read status, read messages stored on your Mac, and open new drafts in your default email app. Reading mail needs access to your Mail folder. | |
|
|
Maps | Provides location services including place search, directions, points of interest lookup, travel time estimation, and static map image generation. |
|
|
Messages | Access message history with specific participants within customizable date ranges. |
|
|
Music | See what's playing in the Music app, control playback, list your playlists and their tracks, and search the Apple Music catalog. Playback and playlist tools need Automation permission for Music; catalog search needs Apple Music access. |
|
|
Notes | Search notes by text, folder, or date, and read them as Markdown with their checklists, tables, and links. |
|
|
Phone | View call history synced from your iPhone, filter calls by participant, date, or call type, and start calls with system confirmation. |
|
|
Reminders | View, create, edit, and delete reminders with customizable due dates, recurrence, priorities, and alerts across different reminder lists, and manage the lists themselves. |
|
|
Shortcuts | List and run shortcuts on your Mac, with optional text input. |
|
|
Voice Memos | Fetch recordings from Voice Memos, with transcripts and audio, filtering by title, folder, or date, or reading Recently Deleted. Needs access to your Voice Memos folder. |
|
|
Voicemail | Fetch voicemails synced from your iPhone, with transcripts and audio, filtering by sender, date, message type, or mailbox (inbox, blocked, or deleted). |
|
|
Weather | Access current weather conditions including temperature, wind speed, and weather conditions for any location. |
When you open the app,
you'll see a
### Turn on services
To turn on a service, click its icon.
macOS asks you for permission.
For example, when you turn on Calendar,
a dialog asks "'iMCP' Would Like Full Access to Your Calendar".
Click "Allow Full Access" to continue.
> [!IMPORTANT]
> iMCP **does not** collect or store any of your data.
> AI apps like Claude and ChatGPT _do_ send
> your data off device as part of tool calls.
> Turn on only the services you want your AI app to use.
> To keep your data on your Mac,
> [use a local model with llama.cpp](#llamacpp).
When a service is on,
its icon changes from gray to the service's color:
red for Calendar, green for Messages, blue for Location, and so on.
Repeat these steps for each service that you want to use.
macOS asks for each permission separately,
so iMCP can access only the data that you allow.
To turn off a service, click its icon again.
To turn off individual tools in a service,
click
The first time an AI app connects,
iMCP shows a "Client Connection Request" dialog
with the name the app reports
and the services that the app can use.
Click "Allow" to connect.
"Allow" turns on a second after the dialog opens,
and pressing Return doesn't click it,
so that a click or a key press meant for another window
doesn't approve a client as the dialog opens.
If you don't answer within two minutes, iMCP denies the connection.
After you deny a client that presents a credential,
iMCP denies connections with that credential
without asking for 30 seconds.
iMCP shows up to three dialogs at once,
and refuses connections while "Enable MCP Server" is off.
Any app can report any name,
so iMCP doesn't trust a client by its name.
Instead, iMCP trusts a client that presents a credential iMCP created for it.
`imcp-server` reads the credential from the `IMCP_CLIENT_CREDENTIAL`
environment variable in the client's MCP settings,
and sends it to iMCP after it checks that iMCP is genuine.
iMCP stores only a hash of each credential, in your Keychain.
To skip the dialog next time, select "Always trust this client".
If the client already presents a credential,
for example because iMCP [set up Claude Desktop](#connect-to-claude-desktop),
iMCP trusts that credential.
Otherwise, iMCP creates a credential and shows it once.
Click "Copy Value"
and add `IMCP_CLIENT_CREDENTIAL` with that value
to the environment of the iMCP server in the client's MCP settings.
iMCP then shows a notification each time the client connects.
You can remove trusted clients in
[Companion][companion] is a utility for testing and debugging your MCP servers
(requires macOS 15 or later).
It gives you an easy way to browse and interact with
a server's prompts, resources, and tools.
Here's how to connect it to iMCP:
1. Click