|
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. |
|
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. |
|
Phone | View call history synced from your iPhone, filter calls by participant, date, or call type, and start calls with system confirmation. |
|
Voicemail | Fetch voicemails synced from your iPhone, with transcripts and audio, filtering by sender, date, message type, or mailbox (inbox, blocked, or deleted). |
|
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. |
|
Weather | Access current weather conditions including temperature, wind speed, and weather conditions for any location. |
When you open the app,
you'll see a
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.
### 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 Allow Full Access 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.
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.
\> "Configure Claude Desktop".
This will add or update the MCP server configuration to use the
`imcp-server` executable bundled in the application.
Other MCP server configurations in the file will be preserved.
\> "Copy server command to clipboard".
Then open `claude_desktop_config.json` in your editor
and enter the following:
```json
{
"mcpServers": {
"iMCP": {
"command": "{paste iMCP server command}"
}
}
}
```
### Call iMCP tools from Claude Desktop
Quit and reopen the Claude Desktop app.
You'll be prompted to approve the connection.
> "Copy server command to clipboard"
2. Open a terminal and run the following commands:
```console
# Download and run inspector package on imcp-server
npx @modelcontextprotocol/inspector [paste-copied-command]
# Open inspector web app running locally
open http://127.0.0.1:6274
```
Inspector lets you see all requests and responses between the client and the iMCP server,
which is helpful for understanding how the protocol works.
### Using Companion
[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 > "Copy server command to clipboard"
2. [Download][companion-download] and open the Companion app
3. Click the + button in the toolbar to add an MCP server
4. Fill out the form:
- Enter "iMCP" as the name
- Select "STDIO" as the transport
- Paste the copied iMCP server command
- Click "Add Server"