Server facts
iMCP MCP Server
Project
- Author
- loopwork-ai
- Repository
- github.com/loopwork-ai/iMCP
- Website
- iMCP.app/download
- License
- MIT
- Category
- Mobile & Desktop Automation
Tech
- Runtime / language
- swiftSwift
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 1,772
- Last commit
- Data as of
Tags
- Calendar
- Contacts
- Macos
- Personal Data
- Swift
Overview
iMCP is a macOS application that makes selected personal-data services available to MCP assistants. Its menu-bar interface lets users activate calendar, contacts, messages, reminders, location, maps, and weather capabilities. The documented actions range from finding contacts and reading message history to creating reminders or calendar events. Mapping features include place searches, directions, travel estimates, and static map images, giving an assistant several ways to combine local context with location-based questions.
Access is enabled service by service through macOS permission dialogs. The README says iMCP does not collect or retain user data, but explicitly warns that connected clients can transmit retrieved information off the device during tool use. Message access uses a separately selected local database file because Apple does not provide a public messages API. These permissions and client trust prompts are an essential part of the workflow, not just optional setup details.
The app bundles an imcp-server executable that communicates with MCP clients over stdio. The command-line bridge and app discover each other through Bonjour and relay requests locally. Tool results use JSON-LD with Schema.org vocabularies. Installation is available as an app download or Homebrew cask and requires macOS 15.3 or later. The app can configure Claude Desktop while preserving existing entries, and the README also provides connections for Claude Code and Amp. Only a contact-fetching tool is named explicitly in the supplied text; other capabilities are described by service.
Install & configure
Requirements
- macOS 15.3 or later
- iMCP app installed and open
- Permissions granted for the chosen services
- An MCP-compatible client
/Applications/iMCP.app/Contents/MacOS/imcp-serverThe executable path appears in the README's Claude Code and Amp commands. Install the app from its download page or with brew install --cask mattt/tap/iMCP. Activate services in the app and approve the connecting client.
Examples are translated from the published configuration. Supply your own credentials and verify requirements in the upstream README. Remote connectors are shown only where a supported configuration format is known.
Config file · macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Use Settings → Developer → Edit Config when available. Do not assume a Linux configuration path; check the client documentation for your platform. Remote servers use the app’s connector flow when supported, not the local stdio file shown here. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"iMCP": {
"command": "/Applications/iMCP.app/Contents/MacOS/imcp-server",
"args": [],
"env": {}
}
}
}Config file · Project: .cursor/mcp.json
User: ~/.cursor/mcp.json
The project path is relative to the workspace root. The tilde denotes your user home directory. Use Cursor’s MCP settings to confirm which configuration and scope your installed version is reading. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"iMCP": {
"command": "/Applications/iMCP.app/Contents/MacOS/imcp-server",
"args": [],
"env": {}
}
}
}Config file · Workspace: .vscode/mcp.json
For user scope, use the “MCP: Open User Configuration” command if available. Do not guess a user configuration path across operating systems, profiles, containers, or remote workspaces; check the client documentation. Merge this example with existing settings; do not overwrite unrelated servers.
{
"servers": {
"iMCP": {
"type": "stdio",
"command": "/Applications/iMCP.app/Contents/MacOS/imcp-server",
"args": [],
"env": {}
}
}
}Config file · macOS/Linux: ~/.codeium/windsurf/mcp_config.json
Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
Open the MCP configuration through Windsurf’s settings when possible to confirm the active file. Paths can differ in managed or future releases; check the client documentation if this location is not present. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"iMCP": {
"command": "/Applications/iMCP.app/Contents/MacOS/imcp-server",
"args": [],
"env": {}
}
}
}Config file · Project scope: .mcp.json at the repository root
The project file uses mcpServers. For user scope, use claude mcp add --scope user rather than assuming .mcp.json in your home directory is the user configuration. Check the client documentation for managed settings and storage details. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"iMCP": {
"type": "stdio",
"command": "/Applications/iMCP.app/Contents/MacOS/imcp-server",
"args": [],
"env": {}
}
}
}Examples are translated from the published configuration. Supply your own credentials and verify requirements in the upstream README. Remote connectors are shown only where a supported configuration format is known.
Tools
Source: repository README. Tool descriptions are a documented snapshot, not a live capability check.
| Tool | What it does |
|---|---|
| fetchContacts | Retrieve contact records through Apple's Contacts framework as JSON-LD. |
Names, permissions, and defaults can change. Check the current upstream documentation before granting access.
Use cases
- Ask an assistant to inspect calendar events or create a reminder.
- Find a contact using a name, email address, or phone number.
- Read message history for selected participants and dates.
- Combine current location with weather or route questions.
Strengths
- Uses macOS permissions to enable services individually.
- Bundles the stdio bridge with the application.
- Provides structured JSON-LD results.
- Can update Claude Desktop configuration without replacing other servers.
Limitations
- Requires macOS 15.3 or newer.
- Connected AI clients may send retrieved personal data off device.
- Message access needs explicit selection of the local message database.
Frequently asked questions
Independent listing, not an affiliation or security review. Grant the least access needed and verify the upstream instructions before running code.
