iMCP

iMCP

A macOS app that provides an MCP server for your iMessage, Reminders, and other Apple services.

955
Stars
45
Forks
9
Releases

Overview

iMCP is a macOS application that provides an MCP server (named iMCP) to connect your digital life with AI. It bundles a command-line executable, imcp-server, that speaks the MCP protocol over a stdio transport. The app and CLI communicate locally via Bonjour for automatic discovery, with both advertising a local _mcp._tcp service. The project leverages the official Swift SDK for MCP servers and clients, and includes Madrid for reading the iMessage database (chat.db) via a typedstream reader. It exposes a curated set of capabilities—Calendar, Contacts, Location, Maps, Messages, Reminders, and Weather—each requiring macOS permissions and toggle-able activation in the UI. Importantly, iMCP does not collect or store user data; however, some data may be sent off-device by MCP clients like Claude Desktop during tool calls. Claude Desktop can be configured automatically through Settings → Developer → Edit Config to use the imcp-server, or manually by copying the server command into claude_desktop_config.json. The project also supports debugging tools such as the MCP Inspector and Companion for testing and exploration, and runs in App Sandbox to minimize data access. Tools return JSON-LD documents, enabling structured data exchange.

Details

Owner
loopwork-ai
Language
Swift
License
MIT License
Updated
2025-12-07

Features

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.

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.

Reminders

View and create reminders with customizable due dates, priorities, and alerts across different reminder lists.

Weather

Access current weather conditions including temperature, wind speed, and weather conditions for any location.

Audience

macOS usersConnects iMCP to Claude Desktop and other MCP clients to access Apple services via AI.

Tags

MCPModel Context ProtocoliMCPClaude DesktopmacOSCalendarContactsLocationMapsMessagesRemindersWeatherJSON-LDMadridSwift SDKBonjourSTDIOCLIiMessage